Bring Your Own Key (BYOK)
Usa le tue chiavi API dei provider in Verdent Desktop e scopri dove sono disponibili i modelli BYOK
Panoramica
BYOK (Bring Your Own Key) ti permette di collegare le tue chiavi API dei provider e usare quei modelli direttamente negli agenti integrati di Verdent.
BYOK vs BYOA
Verdent offre due percorsi "bring your own": non confonderli.
| BYOK | BYOA | |
|---|---|---|
| Cosa porti | Una chiave API di un provider | Un runtime Agent (Codex / Claude Code) |
| Cosa esegue la tua attività | L'agente integrato di Verdent, usando il provider dietro la tua chiave | L'agente CLI esterno sulla tua macchina |
| Caso d'uso tipico | Accedere a un modello con la tua fatturazione, oppure usare un provider non incluso di default | Mantenere il tuo flusso di lavoro Codex / Claude Code esistente lasciando che Manager assegni le attività Worker ad esso |
| Configuralo in | Settings → Models → Configure Models | Settings → Models → CLI Agents |
Consulta BYOA per eseguire le attività Worker su un runtime Agent esterno.
Provider supportati
- Anthropic
- OpenAI
- OpenRouter
Aggiungere una chiave API
Apri la configurazione dei modelli
Vai su Settings → Models → Configure Models.
Inizia ad aggiungere una chiave
Seleziona Add API Key + nell'angolo in alto a destra.
Scegli provider e modelli
Seleziona un provider e scegli i modelli che vuoi abilitare.
Inserisci le credenziali
Aggiungi la tua chiave API.
Salva e convalida
Seleziona Save. Verdent convalida la chiave automaticamente.
Risultati della convalida
- Se la convalida ha esito positivo, la chiave viene salvata e i modelli selezionati diventano disponibili.
- Se la convalida fallisce, Verdent mostra un errore così puoi aggiornare la chiave e riprovare.
Gestire le chiavi API esistenti
In Settings → Models → Configure Models puoi:
- Abilitare o disabilitare tutti i modelli di un provider
- Abilitare o disabilitare singoli modelli
- Modificare una chiave API esistente
- Eliminare una chiave API
Dove compaiono i modelli BYOK
Dopo aver aggiunto una chiave valida, i modelli BYOK compaiono in:
- Il selettore del modello della chat
- La configurazione dei modelli preimpostati
- Le impostazioni dei sottoagenti
- Le impostazioni del reviewer
I modelli BYOK si comportano come i modelli integrati una volta abilitati.
Limitazioni
- Le funzionalità integrate come Smart Suggestions non supportano le chiavi BYOK API.
- La compressione automatica non supporta le chiavi BYOK API.