TravelSwallow Docs

Docs / Chiave IA personale

Chiave IA personale

Come inserire la tua chiave API Anthropic — solo nel browser o cifrata nell'account.

Perché una chiave tua?

La generazione con IA funziona con la tua chiave API. Scegli tu il provider: Anthropic (Claude), OpenAI (GPT), Google Gemini o un endpoint personalizzato compatibile con OpenAI — ognuno con la tua chiave. Così mantieni il controllo su utilizzo e costi, e TravelSwallow resta gratuito — non paghiamo bollette dell’IA al posto tuo e non affidi i tuoi dati a una chiave condivisa. Builder, account, condivisione e profili funzionano del tutto senza chiave.

Ottenere una chiave

Crea una chiave API presso il provider scelto. Il prefisso varia a seconda del provider — in Anthropic, ad esempio, inizia con sk-ant-, in OpenAI con sk-, in Gemini con AIza. Nella pagina IA trovi accanto a ogni provider un link «Ottieni chiave ↗» che ti porta direttamente alla console giusta.

Con i grandi provider carichi un po’ di credito nella loro console — generare un piano di solito costa solo frazioni di centesimo fino a pochi centesimi.

Salvare la chiave in TravelSwallow

Vai alla pagina IA, sezione «La tua chiave IA». Scegli il tuo provider, incolla la chiave e fai clic su Applica. Facoltativamente indichi un modello personalizzato (altrimenti si usa il modello predefinito del provider); per un endpoint personalizzato sono necessari l’URL di base e il nome del modello. Hai due opzioni di archiviazione:

OpzioneDove viene salvataAdatta a
Ricorda nel browser (predefinito)Solo nel tuo browser (localStorage). Inviata a ogni richiesta, mai memorizzata in modo permanente sul server.Massima privacy, un solo dispositivo.
Cifrata nell’account (opzionale)Cifrata con AES-256-GCM nel database, collegata al tuo account.Comodità su più dispositivi.

Modello e costi

Per ogni provider è preimpostato un modello predefinito sensato (ad es. Claude Sonnet, GPT-4o o Gemini 1.5 Pro). Nel campo Modello puoi indicare in qualsiasi momento un altro modello del tuo provider. I costi vengono fatturati direttamente dal provider sul tuo account.

La chiave viene rifiutata?

  • Controlla che la chiave sia copiata per intero e che corrisponda al provider scelto (ad es. sk-ant- per Anthropic).
  • Assicurati che il tuo account del provider abbia credito o una quota attiva.
  • Con un endpoint personalizzato: verifica l’URL di base e il nome del modello — il servizio deve essere compatibile con OpenAI.
  • In caso di «Rate Limit», attendi un momento — è il limite della tua chiave, non di TravelSwallow.