BYOK

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 Configure. 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 Setup your own API key, 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 Settings que reabre o painel do provedor.

​

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: Adicione outra chave com Add new API key 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> 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