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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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ção | Chave sem limite por modelo | Chave limitada a certos modelos |
|---|---|---|
| A chave vaza | Quem tiver a chave pode usar qualquer modelo com seu saldo | Só pode usar os modelos que você habilitou |
| Um erro no código pede outro modelo | A requisição é processada e consome saldo | A 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 chave | Afeta todos os apps que a compartilham | Afeta 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