> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# BYOK

> Conecte OpenAI, Anthropic, Google, AWS e mais de 30 provedores ao AI Gateway com chaves de API BYOK para controlar o faturamento, os limites de taxa e o failover.

**BYOK** (Bring Your Own Key, ou "traga sua própria chave") conecta as chaves de API dos provedores diretamente ao **AI Gateway**. Cada requisição é roteada com essas credenciais, mantendo o faturamento, os limites de taxa e a residência de dados sob o controle da organização.

## Conectar uma chave de provedor

1. Acesse **BYOK** na barra lateral do **AI Gateway**.
2. Encontre o provedor e clique em <kbd>Configure</kbd>. O campo de busca filtra os provedores por nome, e o filtro **Status** alterna a lista entre **All**, **Connected** e **Not Connected**.
3. No painel do provedor, selecione <kbd>Setup your own API key</kbd>, defina um **Name** e cole a **API key**.

Quando um provedor tem pelo menos uma chave, sua linha exibe o selo **Connected** e um botão <kbd>Settings</kbd> que reabre o painel do provedor.

> [card] [Ver todos os provedores compatíveis](/docs/pt-BR/ai-studio/integrations/providers/overview.md)
>
> Veja a lista completa de provedores disponíveis no **AI Gateway**, incluindo OpenAI, Anthropic, Google, AWS Bedrock, Azure e outros.

## Gerenciar chaves de API

O painel do provedor mostra a descrição do provedor, um link **Visit website** e a lista **API Keys** desse provedor. Cada linha de chave mostra o nome da chave, seu valor mascarado e um selo **Default** na chave padrão do workspace para o provedor.

O menu da linha reúne as ações da chave:

| Ação | Descrição |
| - | - |
| **Set as Default** | Torna esta chave aquela com a qual o **AI Gateway** se autentica no provedor. Fica desabilitada na chave que já é a padrão. |
| **Edit** | Renomeia a chave. O campo da chave de API é somente leitura durante a edição. |
| **Delete** | Remove a chave. A exclusão pede confirmação antes. |

Adicione outra chave com <kbd>Add new API key</kbd> no mesmo painel.

### Como a chave padrão é escolhida

As requisições aos modelos de um provedor se autenticam com a chave padrão do provedor ou, quando nenhuma está marcada como padrão, com a primeira chave adicionada. Uma requisição pode selecionar outra chave com o [header `x-toqan-integration-<provider>`](/docs/pt-BR/ai-gateway/features/provider-integrations) quando o modelo não fixa uma integração. Trocar a chave padrão significa promover outra chave, e não editar a atual.

Promova uma chave a qualquer momento com **Set as Default** no menu da linha; o selo passa para a chave promovida.

## Várias chaves por provedor

Ter várias chaves por provedor atende a dois fluxos de trabalho:

* **Rotação de chaves**: adicione a chave substituta junto à ativa e promova-a com **Set as Default** quando a chave antiga for revogada ou esgotada.
* **Separação de ambientes**: as chaves pertencem a um único workspace, então um workspace que atende um ambiente que não é de produção mantém suas próprias credenciais de provedor.

## Por que usar suas próprias chaves

Para cargas de trabalho em produção, o BYOK oferece:

* **Controle dos limites de taxa**: os limites de taxa do provedor se aplicam à conta da organização, não a um pool compartilhado
* **Faturamento direto**: os gastos são cobrados diretamente pelo provedor; configure limites e alertas de forma independente
* **Residência de dados**: as requisições vão do **AI Gateway** para a conta do provedor sem uma camada de credenciais compartilhada


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.