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:
- 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.
- 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 #
- Abra Configurações → BYOK.
- Clique em Adicionar chave ao lado do provedor.
- 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ção | O que acontece |
|---|---|
| Você tem uma chave do provedor do modelo, ela está ativada e o provedor permite acessar o modelo com ela | A solicitação usa sua chave |
| Não há chave para esse provedor | A localização com um modelo do catálogo usa seus créditos da Lingo.dev |
| A chave está desativada | A 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á desativada | A 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 chave | Para 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ção | O que fazer |
|---|---|
| O provedor limita a taxa de solicitações da sua chave | Tente 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 esgotaram | Adicione créditos ou aumente a cota com o provedor e tente novamente |
| O provedor rejeita sua chave, por exemplo, porque ela foi revogada | Substitua a chave em Configurações → BYOK e tente novamente |
| A Lingo.dev não consegue ler a chave armazenada | Salve 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á.