---
title: Bring Your Own Key (BYOK)
description: "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](/docs/verdent-manager/configuration/byoa) para executar tarefas de Worker em um runtime de Agent externo.

## Provedores suportados

- Anthropic
- OpenAI
- OpenRouter

## Adicionar uma chave API

<Steps>
  <Step title="Abra a configuração de modelos">
    Vá em **Settings → Models → Configure Models**.
  </Step>
  <Step title="Comece a adicionar uma chave">
    Clique em **Add API Key +** no canto superior direito.
  </Step>
  <Step title="Escolha o provedor e os modelos">
    Selecione um provedor e escolha os modelos que deseja habilitar.
  </Step>
  <Step title="Insira as credenciais">
    Adicione sua chave API.
  </Step>
  <Step title="Salve e valide">
    Clique em **Save**. O Verdent valida a chave automaticamente.
  </Step>
</Steps>

### 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.