Utilize a sua própria chave (BYOK)

Guarde as chaves da sua organização para Anthropic, OpenAI, Google e Mistral AI, para que os pedidos de localização utilizem a sua chave e sejam faturados diretamente pelo fornecedor.

Utilize a sua própria chave de API de um fornecedor de modelos para a localização. Adicione a chave da sua organização na página BYOK, em Definições, e escolha um modelo para a localização. Os pedidos que recorrem aos modelos desse fornecedor utilizam a sua chave, e o fornecedor fatura-lhe diretamente os tokens. Disponível no plano Enterprise.

Fornecedores suportados: Anthropic, OpenAI, Google e Mistral AI.

Localização com a sua chave #

Outras funcionalidades, como os avaliadores de IA e as sugestões do motor, não requerem uma chave de fornecedor nem a seleção de um modelo.

Faturação #

Quando a localização utiliza a sua chave, o fornecedor fatura-lhe os tokens do modelo e a Lingo.dev não cobra o custo do modelo. A taxa de infraestrutura da Lingo.dev para conteúdo localizado continua a aplicar-se. Quando a localização não utiliza a sua chave, o custo do modelo é pago com os seus créditos Lingo.dev.

Quem pode gerir chaves #

A gestão de chaves na página BYOK está sujeita a duas condições:

  1. 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 no plano, é apresentada a mensagem "A utilização de chaves próprias de fornecedores não está disponível no seu plano" e não é possível guardar uma chave.
  2. Permissão: para adicionar, substituir, ativar, desativar ou remover uma chave, o membro tem de ter a permissão Gerir definições (org:manage_settings) na sua função. Sem RBAC, todos os membros têm a função de Proprietário e dispõem desta permissão.

Todos os membros podem ver que fornecedores têm uma chave e se esta está a ser utilizada. Não é possível alterar as chaves com uma chave de API da organização. Para o fazer, inicie sessão com uma conta de utilizador.

Adicionar uma chave #

  1. Abra Definições → BYOK.
  2. Clique em Adicionar chave junto ao fornecedor.
  3. 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 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 quando foi atualizada. Para a alterar, utilize Substituir e cole uma nova chave.

Utilizar os modelos de um fornecedor #

A sua chave é utilizada quando um pedido de localização recorre a um modelo desse fornecedor. Para utilizar a sua chave nos passos de localização de um motor, escolha um modelo desse fornecedor na configuração de modelos do motor.

SituaçãoO que acontece
Tem uma chave para o fornecedor do modelo, a chave está ativada e o fornecedor disponibiliza o modelo através delaO pedido utiliza a sua chave
Não existe uma chave para esse fornecedorA localização com um modelo do catálogo utiliza os seus créditos Lingo.dev
A chave está desativadaA localização com um modelo do catálogo utiliza os seus créditos Lingo.dev
O modelo não consta do catálogo de modelos da Lingo.dev e a sua chave para esse fornecedor está em falta ou desativadaA localização com esse modelo falha porque a chave da Lingo.dev não permite aceder-lhe
O fornecedor recusa o acesso ao modelo com a sua chaveSe o modelo constar do catálogo, é feita uma nova tentativa com os seus créditos Lingo.dev; se não constar, a execução falha

Etiqueta BYOK

A sua chave só é utilizada quando o fornecedor disponibiliza o modelo com o ID exato definido no seu motor. Os seletores de modelos e a configuração de modelos do seu motor assinalam com BYOK os modelos acessíveis com a sua chave. Um modelo guardado com a etiqueta Não BYOK não está acessível com a sua chave, pelo que a localização com esse modelo utiliza os seus créditos Lingo.dev. Um modelo guardado com a etiqueta Requer chave da Mistral AI não consta do catálogo de modelos da Lingo.dev e só pode ser executado com a sua chave da Mistral AI, que está em falta ou desativada. Adicione ou ative a chave, ou escolha outro modelo.

Uma chave em falta ou desativada nunca impede a localização com um modelo do catálogo.

Modelos fora do catálogo #

Os seletores de modelos também disponibilizam modelos de conversação acessíveis com a sua chave da Mistral AI que não constam do catálogo de modelos da Lingo.dev, como mistralai/zai-glm-5-3. Têm a etiqueta BYOK e aparecem como provider/model, com uma única entrada por modelo, sob o respetivo ID atribuído pela Mistral AI. Um modelo guardado com um dos seus nomes alternativos, como mistralai/zai-glm-latest, também utiliza a sua chave.

Estes modelos só podem ser executados com a sua chave, porque a chave da própria Lingo.dev não permite aceder-lhes. Por enquanto, apenas a lista de modelos da Mistral AI indica quais são os modelos de conversação, pelo que as chaves de outros fornecedores não adicionam modelos fora do catálogo.

Quando a sua chave é recusada #

Estas falhas interrompem o pedido de localização. Não é feita uma nova tentativa com os seus créditos Lingo.dev, nem se passa ao modelo seguinte na configuração de modelos do motor. A mensagem de erro indica o fornecedor e o que deve corrigir.

SituaçãoO que fazer
O fornecedor limita a frequência dos pedidos com a sua chaveTente novamente dentro de alguns minutos ou aumente os limites de frequência da chave junto do fornecedor
Os créditos ou a quota da sua conta do fornecedor esgotaram-seAdicione créditos ou aumente a quota junto do fornecedor e tente novamente
O fornecedor rejeita a sua chave, por exemplo, por ter sido revogadaSubstitua a chave em Definições → BYOK e tente novamente
A Lingo.dev não consegue ler a chave guardadaVolte a guardar a chave em Definições → BYOK e tente novamente

Estes limites dizem respeito à sua conta, pelo que uma nova tentativa com créditos Lingo.dev ocultaria o problema.

Desativar uma chave #

Desative a chave para deixar de a utilizar sem a eliminar. A página apresenta Desativada e a localização com os modelos do catálogo desse fornecedor utiliza os seus créditos Lingo.dev até voltar a ativar a chave. Os modelos fora do catálogo não são executados enquanto a chave estiver desativada.

Se o seu plano deixar de permitir a utilização de chaves próprias, uma chave guardada apresenta o estado Guardada, sem utilização. A localização com os modelos do catálogo desse fornecedor utiliza os seus créditos Lingo.dev e os modelos fora do catálogo não são executados. A chave mantém-se guardada até a remover.

Remover uma chave #

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

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 na sua conta desse fornecedor.