BYOK — Imposta la tua chiave API
BYOK (Bring Your Own Key, "porta la tua chiave") significa usare la tua chiave API di un provider di modelli AI al posto di quella fornita da NeoAgent. Si configura in General Settings → Modello AI, alla voce Chiave API modello.
Cos'è una chiave API
Una chiave API è una credenziale segreta che autorizza l'accesso a un servizio AI. Il provider la usa per:
- identificare il tuo account,
- addebitare i consumi sulla tua quota,
- applicare i limiti del tuo piano.
A cosa serve il BYOK
- Controllo dei costi: i consumi vengono fatturati direttamente sul tuo account del provider.
- Quote e limiti tuoi: usi il tier e i rate limit del tuo account.
- Modelli specifici: accedi ai modelli abilitati sulla tua chiave.
- Compliance: il traffico verso il provider segue il tuo contratto.
Se lasci il campo vuoto, NeoAgent usa la propria chiave (crediti della piattaforma).
Dove inserirla
- Apri il tuo Chatbot → General Settings → Modello AI.
- Seleziona il Modello (es.
gpt-5). - Nel campo Chiave API modello incolla la chiave del provider corrispondente. Il link "Clicca qui per ottenere la tua chiave API" apre il portale giusto.
- Salva. Con la X rimuovi la chiave e torni alla chiave NeoAgent.
La chiave deve appartenere allo stesso provider del modello selezionato (es. modello OpenAI → chiave OpenAI). Una chiave di un altro provider genera errori di autenticazione.
Dove ottenere la chiave
| Provider | Modelli tipici | Dove creare la chiave API |
|---|---|---|
| OpenAI | GPT-5, GPT-Realtime | https://platform.openai.com/api-keys |
| Anthropic | Claude (Opus, Sonnet, Haiku) | https://console.anthropic.com/settings/keys |
| Gemini | https://aistudio.google.com/app/apikey | |
| xAI | Grok | https://console.x.ai/ |
| DeepSeek | DeepSeek Chat / Reasoner | https://platform.deepseek.com/api_keys |
| Mistral | Mistral | https://console.mistral.ai/api-keys/ |
Per ogni provider: accedi al portale sviluppatori, crea una nuova chiave e copiala. Per i modelli a consumo serve un account con metodo di pagamento attivo.
Sicurezza
- La chiave è un segreto: non condividerla, non committarla, non incollarla in chat.
- Puoi revocarla in qualsiasi momento dal portale del provider.
- Imposta dei limiti di spesa sul provider per evitare costi imprevisti.
- NeoAgent memorizza la chiave solo per eseguire le chiamate del tuo agente.
Dopo aver salvato, invia un messaggio di test al chatbot. Se compare un errore di autenticazione, la chiave è errata o appartiene a un altro provider.