Use a sua própria chave (BYOK)
Guarde as chaves de API da sua organização para fornecedores de modelos na página BYOK, em Definições. Os pedidos de localização que utilizem modelos desse fornecedor passam a ser enviados diretamente para o fornecedor com a sua chave e são-lhe faturados pelo próprio fornecedor. Disponível no plano Enterprise.
Fornecedores compatíveis: Anthropic, OpenAI, Google e Mistral AI.
Que pedidos usam a sua chave#
Só a localização usa a sua chave. Tudo o resto continua a usar a chave da Lingo.dev.
| Pedido | Chave |
|---|---|
| Localização: a API localize, as tarefas de localização, o Playground e todas as etapas de localização executadas por um motor | A sua chave, se tiver uma para o fornecedor desse modelo |
| Controlo de qualidade | Chave da Lingo.dev |
| Avaliadores de IA | Chave da Lingo.dev |
| Sugestões do motor | Chave da Lingo.dev |
Faturação#
Quando um pedido é executado com a sua chave, o fornecedor cobra-lhe os tokens consumidos.
Quem pode gerir chaves#
O acesso à página BYOK depende de duas condições:
- Disponibilidade no plano: a funcionalidade BYOK tem de estar ativada para a organização (plano Enterprise). A página aparece sempre em Definições. Se a funcionalidade não estiver disponível, apresenta a mensagem "O seu plano não permite usar as suas próprias chaves de fornecedores" e não pode guardar uma chave.
- Permissão: para adicionar, substituir, ativar, desativar ou remover uma chave, o membro precisa da permissão Gerir definições (
org:manage_settings) na sua função. Sem RBAC, todos os membros são Proprietários e têm esta permissão.
Todos os membros podem ver que fornecedores têm uma chave e se essa chave está a ser utilizada. Não é possível alterar chaves com uma chave de API da organização. Para isso, inicie sessão com uma conta de utilizador.
Adicionar uma chave#
- Abra Definições → BYOK.
- Clique em Adicionar chave junto ao fornecedor.
- Cole a chave de API e guarde.
Ao guardar a chave, a Lingo.dev verifica-a junto do fornecedor. Se o fornecedor não a aceitar, a chave não é guardada. Verifique-a na sua conta junto do fornecedor e volte a colá-la.
Visibilidade da chave
Depois de guardada, a chave nunca volta a ser apresentada. A página mostra apenas os últimos quatro carateres e a data de atualização da chave. Para a alterar, use Substituir e cole uma nova chave.
Usar os modelos de um fornecedor#
A sua chave é utilizada quando um motor chama um modelo desse fornecedor. Para executar um modelo de um fornecedor com a sua chave, selecione esse modelo na configuração de modelos do motor.
| Situação | O que acontece |
|---|---|
| Tem uma chave para o fornecedor do modelo e está ativada | O pedido usa a sua chave |
| Não tem uma chave para esse fornecedor | O pedido usa a chave da Lingo.dev e os seus créditos, como antes |
| A chave está desativada | O pedido usa a chave da Lingo.dev e os seus créditos |
| O fornecedor recusa o acesso ao modelo com a sua chave | O pedido é repetido com a chave da Lingo.dev e os seus créditos |
Não ter uma chave ou tê-la desativada nunca interrompe a localização. No entanto, se o fornecedor recusar o acesso ao modelo depois de este começar a responder, o pedido pode falhar. Para evitar isso, dê à sua chave acesso ao modelo ou escolha outro modelo.
Quando a sua chave é recusada#
As falhas abaixo interrompem o pedido. O pedido não passa a usar a chave da Lingo.dev nem avança para o modelo seguinte na configuração de modelos do motor. A mensagem de erro identifica o fornecedor e indica o que deve corrigir.
| Situação | O que fazer |
|---|---|
| O fornecedor limita a frequência dos pedidos feitos com a sua chave | Tente novamente dentro de alguns minutos ou aumente os limites de frequência da chave junto do fornecedor |
| A sua conta junto do fornecedor esgotou os créditos ou a quota | Adicione créditos ou aumente a quota junto do fornecedor e tente novamente |
| O fornecedor rejeita a sua chave, por exemplo, por ter sido revogada | Substitua a chave em Definições → BYOK e tente novamente. |
| A Lingo.dev não consegue ler a chave guardada | Volte a guardar a chave em Definições → BYOK e tente novamente. |
Como estes limites e esta conta são seus, encaminhar o tráfego para a chave da Lingo.dev iria ocultar-lhe o problema.
Desativar uma chave#
Desative a chave para deixar de a usar sem a eliminar. A página mostra Desativada, e os modelos desse fornecedor passam a usar a chave da Lingo.dev e os seus créditos até voltar a ativar a chave.
Se o seu plano deixar de permitir o uso das suas próprias chaves, a chave guardada apresenta o estado Guardada, sem utilização. Os modelos desse fornecedor usam a chave da Lingo.dev e os seus créditos. A chave permanece guardada até a remover.
Remover uma chave#
Clique em Remover chave. A chave é eliminada da Lingo.dev, e os modelos desse fornecedor voltam a usar a chave da Lingo.dev e os seus créditos.
Revogue-a junto do fornecedor
Remover uma chave da Lingo.dev não a revoga. A chave continua válida junto do fornecedor até a revogar junto dele.