Use sua própria chave (BYOK)
Salve as chaves de API da sua organização para provedores de modelos na página BYOK, em Configurações. As solicitações de localização para os modelos desse provedor passam a ser enviadas diretamente a ele usando sua chave, e o próprio provedor cobra por elas. Disponível no plano Enterprise.
Provedores compatíveis: Anthropic, OpenAI, Google e Mistral AI.
Quais solicitações usam sua chave#
Só as solicitações de localização usam sua chave. Todo o restante continua usando a chave da Lingo.dev.
| Solicitação | Chave |
|---|---|
| Localização: a API localize, as tarefas de localização, o Playground e cada etapa de localização executada por um engine | Sua chave, se você tiver uma para o provedor do modelo |
| Controle de qualidade | Chave da Lingo.dev |
| Avaliadores de IA | Chave da Lingo.dev |
| Sugestões de engine | Chave da Lingo.dev |
Cobrança#
Quando uma solicitação é executada com sua chave, o provedor cobra de você pelos tokens utilizados.
Quem pode gerenciar chaves#
O acesso à página BYOK depende de dois requisitos:
- Disponibilidade do recurso: o recurso BYOK precisa estar habilitado para a organização (plano Enterprise). A página sempre aparece em Configurações. Se o recurso não estiver habilitado, 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, o membro precisa ter a permissão Gerenciar configurações (
org:manage_settings) na sua função. Sem RBAC, todos os membros são Proprietários e têm 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 chaves usando uma chave de API da organização. Para isso, entre com uma 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 ele não a aceitar, a chave não será salva. Confira a chave na sua conta do provedor e cole novamente.
Visibilidade da chave
Depois de salva, a chave nunca mais é exibida por completo. 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 um engine chama um modelo desse provedor. Para usar sua chave com um modelo do provedor, selecione esse modelo na configuração de modelos do engine.
| Situação | O que acontece |
|---|---|
| Você tem uma chave para o provedor do modelo e ela está ativada | A solicitação usa sua chave |
| Não há chave para esse provedor | A solicitação usa a chave da Lingo.dev e seus créditos, como antes |
| A chave está desativada | A solicitação usa a chave da Lingo.dev e seus créditos |
| O provedor recusa o uso do modelo com sua chave | A solicitação é repetida com a chave da Lingo.dev e seus créditos |
A ausência de uma chave ou uma chave desativada nunca interrompe a localização. Porém, se o provedor recusar o modelo só depois de começar a responder, a solicitação poderá falhar. Para evitar isso, dê à sua chave acesso ao modelo ou escolha outro modelo.
Quando sua chave é recusada#
As falhas abaixo interrompem a solicitação. Ela não passa a usar a chave da Lingo.dev nem o próximo modelo na configuração de modelos do engine. A mensagem de erro indica 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 aumente os limites de solicitações da chave junto ao provedor |
| Sua conta no provedor está sem créditos ou cota disponível | Adicione créditos ou aumente a cota junto ao 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 de novo em Configurações → BYOK e tente novamente |
Como esses limites são seus e a conta também, redirecionar o tráfego para a chave da Lingo.dev impediria que você percebesse o problema.
Desativar uma chave#
Desative a chave para deixar de usá-la sem excluí-la. A página exibe Desativada, e os modelos desse provedor passam a usar a chave da Lingo.dev e seus créditos até você reativar a chave.
Se seu plano deixar de permitir o uso de chaves próprias, a chave armazenada aparecerá como Armazenada, não está em uso. Os modelos desse provedor usarão a chave da Lingo.dev e seus créditos. A chave continuará armazenada até você removê-la.
Remover uma chave#
Clique em Remover chave. A chave é excluída da Lingo.dev, e os modelos desse provedor voltam a usar a chave da Lingo.dev e seus créditos.
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á.