Como limitar uma chave de API a certos modelos de IA?

Crie uma chave por app ou ambiente no Dongee AI Router, restrinja cada uma aos modelos de que ela precisa, guarde a chave nas variáveis de ambiente do servidor e acompanhe o consumo para evitar vazamentos e gastos inesperados.

Para limitar uma chave de API a modelos de IA específicos com o Dongee AI Router, uma API unificada e compatível com OpenAI para vários modelos, crie uma chave para cada app ou ambiente e, na sua área de cliente, restrinja-a aos modelos que esse app usa. Guarde a chave nas variáveis de ambiente do servidor, nunca no navegador.

Depois, acompanhe o consumo de cada chave. Assim, você reduz o estrago se uma chave vazar e controla melhor os gastos.

Por que vale a pena limitar cada chave a certos modelos

Uma chave sem restrições dá acesso a todos os modelos disponíveis. Se alguém conseguir essa chave, ou se um erro no seu código mandar requisições para um modelo inesperado, o consumo sai do seu saldo. Ao limitar a chave aos modelos de que você precisa, esse risco fica restrito a um conjunto pequeno e conhecido de modelos.

O Dongee AI Router é uma API unificada para vários modelos de IA. Ele prioriza modelos rápidos hospedados no data center da Dongee no Canadá, funciona com saldo pré-pago a partir de 3 USD e não cobra mensalidade. É compatível com o padrão da OpenAI e permite criar quantas chaves você quiser por conta, cada uma limitada aos modelos que você escolher.

Passo a passo para limitar uma chave de API a certos modelos

  1. Ative o AI Router e adicione saldo. A ativação é feita na sua área de cliente da Dongee (é preciso ser cliente). O saldo é pré-pago a partir de 3 USD, e as contas novas recebem um crédito de boas-vindas.
  2. Crie uma chave por aplicação ou ambiente. Por exemplo, uma para o chatbot em produção, outra para o mesmo chatbot em testes e outra para um fluxo do n8n. Como não há limite de chaves por conta, você não precisa compartilhar a mesma chave entre projetos.
  3. Restrinja cada chave aos modelos necessários. A lista de modelos disponíveis aparece na sua área de cliente. Marque apenas os que esse app usa. Se o seu ambiente de testes usa um modelo rápido e econômico, não dê acesso aos outros.
  4. Guarde a chave nas variáveis de ambiente do servidor. Não coloque a chave no código-fonte, em um repositório do GitHub nem no JavaScript que roda no navegador. Se a chave chegar ao navegador, qualquer pessoa pode vê-la e gastar seu saldo.
  5. Troque a URL base e a chave no seu código. Como o AI Router é compatível com OpenAI, você só muda esses dois valores. Copie a URL base que aparece na sua área de cliente.
  6. Acompanhe o consumo por chave. Na área de cliente, você vê o consumo por modelo e por chave, além do detalhe de cada requisição. Se uma chave gastar mais do que o normal, você já sabe qual app está causando isso.

Exemplo em Node.js com o SDK da OpenAI

Os nomes AI_ROUTER_BASE_URL e AI_ROUTER_API_KEY são só um exemplo, e você pode usar os que preferir. Na primeira variável, coloque a URL base que aparece na sua área de cliente. Na segunda, coloque a chave limitada desse app.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: process.env.AI_ROUTER_BASE_URL, apiKey: process.env.AI_ROUTER_API_KEY });

const resposta = await client.chat.completions.create({ model: "MODELO_PERMITIDO", messages: [{ role: "user", content: "Olá" }] });

console.log(resposta.choices[0].message.content);

Substitua MODELO_PERMITIDO por um dos modelos da lista da área de cliente que você habilitou para essa chave. Este código deve rodar no seu servidor, por exemplo em uma API Node.js, e nunca no navegador. O AI Router também aceita streaming, caso você queira mostrar a resposta enquanto ela é gerada.

Com e sem limite por modelo

SituaçãoChave sem limite por modeloChave limitada a certos modelos
A chave vazaQuem tiver a chave pode usar qualquer modelo com seu saldoSó pode usar os modelos que você habilitou
Um erro no código pede outro modeloA requisição é processada e consome saldoA chave não funciona para modelos que você não autorizou
Análise de gastosÉ difícil saber qual app consumiu o quêCom uma chave por app, o consumo por chave mostra isso com clareza
Trocar ou revogar a chaveAfeta todos os apps que a compartilhamAfeta só um app ou ambiente

Quando o AI Router vale a pena e quando não

Vale a pena se você quer uma única API compatível com OpenAI, pagar só pelo que usa, sem mensalidade, e controlar os gastos com várias chaves limitadas. Também serve se você já usa um gateway próprio, como o LiteLLM, porque o AI Router pode ficar por trás dele.

Não vale a pena nestes casos:

  • Você precisa de um modelo que não aparece na lista da área de cliente.
  • Você espera que o provedor troque de modelo automaticamente quando um falha. A Dongee não faz fallback próprio, então você mesmo programa o roteamento. Se esse tema interessa a você, veja este guia sobre roteamento inteligente entre modelos de linguagem.
  • Seu app não tem backend, e você quer chamar a API direto do navegador. Antes, você precisa de uma camada de servidor.
  • Você não quer ser cliente da Dongee, o que é um requisito para ativar o serviço.

Perguntas frequentes

Quantas chaves de API posso criar?

Quantas quiser, porque não há limite de chaves por conta. O recomendado é ter uma por aplicação e por ambiente.

Posso usar a chave no frontend se eu limitar a um único modelo?

Não é recomendável. Mesmo limitada, qualquer pessoa que veja a chave pode gastar seu saldo com esse modelo. Guarde a chave no servidor e faça o frontend chamar o seu próprio backend.

O que acontece se o saldo acabar?

As requisições param, e você não fica com dívida. Acompanhe o consumo por chave para recarregar a tempo.

A Dongee guarda o conteúdo das minhas conversas?

Não. O AI Router registra apenas os dados de faturamento de cada requisição, nunca o conteúdo.

Limitar modelos também ajuda a gastar menos tokens?

Ajuda a controlar quais modelos são usados, mas a economia também depende dos seus prompts e de como você roteia as requisições. Veja mais neste guia para otimizar o consumo de tokens com roteadores de IA.

Em resumo

Use uma chave por app ou ambiente, limite cada chave aos modelos de que ela precisa, guarde a chave no servidor e acompanhe o consumo. Com esses quatro hábitos, você reduz o risco de vazamentos e de gastos inesperados. Para completar a segurança do seu projeto, veja como ter um app feito com IA seguro e sem quedas.

Comenta lo que quieras

Unete a la charla
Solo ingresa tu email