# Bring Your Own Key (BYOK) (/pt/docs/verdent-manager/configuration/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 [#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 [#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 [#provedores-suportados]

* Anthropic
* OpenAI
* OpenRouter

## Adicionar uma chave API [#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 &#x2A;*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 [#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 [#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 [#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 [#limitações]

* Recursos integrados como Smart Suggestions não suportam chaves BYOK API.
* A compressão automática não suporta chaves BYOK API.