Bring Your Own Key (BYOK)
Use suas próprias chaves API de provedor no Verdent Desktop e entenda onde os modelos BYOK estão disponíveis
Visão geral
BYOK (Bring Your Own Key) permite conectar suas próprias chaves API de provedor e usar esses modelos diretamente nos agentes integrados do Verdent.
BYOK vs BYOA
O Verdent oferece dois caminhos "bring your own"—não os confunda:
| BYOK | BYOA | |
|---|---|---|
| O que você traz | Uma chave API de provedor | Um runtime de Agent (Codex / Claude Code) |
| O que executa sua tarefa | O agente integrado do Verdent, usando o provedor por trás da sua chave | O agente CLI externo na sua máquina |
| Caso de uso típico | Acessar um modelo sob seu próprio faturamento, ou usar um provedor não incluído por padrão | Manter seu fluxo de trabalho existente do Codex / Claude Code enquanto o Manager despacha tarefas de Worker para ele |
| Configurar em | Settings → Models → Configure Models | Settings → Models → CLI Agents |
Consulte BYOA para executar tarefas de Worker em um runtime de Agent externo.
Provedores suportados
- Anthropic
- OpenAI
- OpenRouter
Adicionar uma chave API
Abra a configuração de modelos
Vá em Settings → Models → Configure Models.
Comece a adicionar uma chave
Clique em Add API Key + no canto superior direito.
Escolha o provedor e os modelos
Selecione um provedor e escolha os modelos que deseja habilitar.
Insira as credenciais
Adicione sua chave API.
Salve e valide
Clique em Save. O Verdent valida a chave automaticamente.
Resultados da validação
- Se a validação for bem-sucedida, a chave é salva e os modelos selecionados ficam disponíveis.
- Se a validação falhar, o Verdent mostra um erro para que você possa atualizar a chave e tentar novamente.
Gerenciar chaves API existentes
Em Settings → Models → Configure Models, você pode:
- Habilitar ou desabilitar todos os modelos de um provedor
- Habilitar ou desabilitar modelos individuais
- Editar uma chave API existente
- Excluir uma chave API
Onde os modelos BYOK aparecem
Depois de adicionar uma chave válida, os modelos BYOK aparecem em:
- O seletor de modelo do chat
- A configuração de modelo de preset
- As configurações de subagente
- As configurações de reviewer
Os modelos BYOK se comportam como modelos integrados depois de habilitados.
Limitações
- Recursos integrados como Smart Suggestions não suportam chaves BYOK API.
- A compressão automática não suporta chaves BYOK API.