Use sua própria chave (BYOK)

Armazene as chaves da sua organização para Anthropic, OpenAI, Google e Mistral AI para que as solicitações de localização usem sua chave, com cobrança direta pelo provedor.

Use sua própria chave de API de um provedor de modelos para localização. Adicione a chave da sua organização na página BYOK, em Configurações, e escolha um modelo para localização. As solicitações aos modelos desse provedor usam sua chave, e os tokens são cobrados diretamente pelo provedor. Disponível no plano Enterprise.

Provedores compatíveis: Anthropic, OpenAI, Google e Mistral AI.

Localização com sua chave #

Outros recursos, como avaliadores de IA e sugestões de engine, não exigem uma chave de provedor nem a seleção de um modelo.

Cobrança #

Quando a localização usa sua chave, o provedor cobra pelos tokens do modelo diretamente de você, e a Lingo.dev não cobra o custo do modelo. A taxa de infraestrutura da Lingo.dev para conteúdo localizado continua sendo aplicada. Quando a localização não usa sua chave, o custo do modelo é pago com seus créditos da Lingo.dev.

Quem pode gerenciar chaves #

Dois requisitos controlam o uso da página BYOK:

  1. Acesso ao recurso: o BYOK precisa estar habilitado para a organização (plano Enterprise). A página sempre aparece em Configurações. Sem acesso ao recurso, ela exibe "O uso de chaves próprias de provedores não está disponível no seu plano", e você não pode salvar uma chave.
  2. Permissão: para adicionar, substituir, ativar, desativar ou remover uma chave, é preciso ter a permissão Gerenciar configurações (org:manage_settings) na função do membro. Sem RBAC, todos os membros têm a função de Proprietário e essa permissão.

Todos os membros podem ver quais provedores têm uma chave e se ela está em uso. Não é possível alterar as chaves usando uma chave de API da organização. Para isso, entre com sua conta de usuário.

Adicionar uma chave #

  1. Abra Configurações → BYOK.
  2. Clique em Adicionar chave ao lado do provedor.
  3. Cole a chave de API e salve.

Ao salvar, a Lingo.dev verifica a chave com o provedor. Se o provedor não a aceitar, ela não será salva. Confira a chave na sua conta no provedor e cole-a novamente.

Visibilidade da chave

Depois de salva, a chave nunca mais é exibida. A página mostra apenas os quatro últimos caracteres e quando ela foi atualizada. Para alterá-la, use Substituir e cole uma nova chave.

Usar os modelos de um provedor #

Sua chave é usada quando uma solicitação de localização chama um modelo desse provedor. Para usá-la nas etapas de localização de um engine, defina um modelo desse provedor na configuração de modelos do engine.

SituaçãoO que acontece
Você tem uma chave do provedor do modelo, ela está ativada e o provedor permite acessar o modelo com elaA solicitação usa sua chave
Não há chave para esse provedorA localização com um modelo do catálogo usa seus créditos da Lingo.dev
A chave está desativadaA localização com um modelo do catálogo usa seus créditos da Lingo.dev
O modelo não está no catálogo de modelos da Lingo.dev, e você não tem uma chave para esse provedor ou ela está desativadaA localização com esse modelo falha porque a chave da Lingo.dev não permite acessá-lo
O provedor recusa o acesso ao modelo com sua chavePara um modelo do catálogo, há uma nova tentativa com seus créditos da Lingo.dev; para um modelo fora do catálogo, a solicitação falha

Etiqueta BYOK

Sua chave só é usada quando o provedor permite acessar o modelo com o ID exato definido no seu engine. Os seletores de modelos e a configuração de modelos do seu engine identificam com BYOK os modelos disponíveis com sua chave. Um modelo salvo com a etiqueta Não BYOK não está disponível com sua chave, então a localização com ele usa seus créditos da Lingo.dev. Um modelo salvo com a etiqueta Requer chave da Mistral AI não está no catálogo de modelos da Lingo.dev e só pode ser executado com sua chave da Mistral AI, mas essa chave não foi adicionada ou está desativada. Adicione ou ative a chave, ou escolha outro modelo.

A falta de uma chave ou uma chave desativada nunca impede a localização com um modelo do catálogo.

Modelos fora do catálogo #

Os seletores de modelos também oferecem modelos de chat disponíveis com sua chave da Mistral AI que não estão no catálogo de modelos da Lingo.dev, como mistralai/zai-glm-5-3. Eles recebem a etiqueta BYOK e aparecem como provider/model, uma vez por modelo, com o ID atribuído pela própria Mistral AI. Um modelo salvo com um de seus nomes alternativos, como mistralai/zai-glm-latest, também usa sua chave.

Esses modelos só podem ser executados com sua chave, porque a chave da própria Lingo.dev não permite acessá-los. Por enquanto, apenas a lista de modelos da Mistral AI informa quais são modelos de chat, então as chaves de outros provedores não adicionam modelos fora do catálogo.

Quando sua chave é recusada #

Essas falhas interrompem a solicitação de localização. Não há uma nova tentativa com seus créditos da Lingo.dev, nem o uso do próximo modelo na configuração de modelos do engine. A mensagem de erro informa o provedor e o que precisa ser corrigido.

SituaçãoO que fazer
O provedor limita a taxa de solicitações da sua chaveTente novamente em alguns minutos ou solicite ao provedor um aumento nos limites de solicitações da chave
Os créditos ou a cota da sua conta no provedor se esgotaramAdicione créditos ou aumente a cota com o provedor e tente novamente
O provedor rejeita sua chave, por exemplo, porque ela foi revogadaSubstitua a chave em Configurações → BYOK e tente novamente
A Lingo.dev não consegue ler a chave armazenadaSalve a chave novamente em Configurações → BYOK e tente novamente

Como os limites e a conta são seus, tentar novamente com créditos da Lingo.dev faria com que você não percebesse o problema.

Desativar uma chave #

Desative a chave para parar de usá-la sem excluí-la. A página mostra Desativada, e a localização com os modelos do catálogo desse provedor usa seus créditos da Lingo.dev até você reativar a chave. Os modelos fora do catálogo não são executados enquanto a chave está desativada.

Se seu plano deixar de permitir o uso de chaves próprias, a chave armazenada aparecerá como Armazenada, sem uso. A localização com os modelos do catálogo desse provedor usa seus créditos da Lingo.dev, e os modelos fora do catálogo não são executados. A chave permanece armazenada até você removê-la.

Remover uma chave #

Clique em Remover chave. A chave é excluída da Lingo.dev. A localização com os modelos do catálogo desse provedor volta a usar seus créditos da Lingo.dev, e os modelos fora do catálogo deixam de ser executados.

Revogue a chave no provedor

Remover uma chave da Lingo.dev não a revoga. Ela continua válida no provedor até você revogá-la por lá.