Segurança de chaves de API de IA e controle de custos
Proteja cargas de IA com chaves separadas, cotas, expiração, limites de modelos, listas de IPs permitidos, política de roteamento, rotação e custos auditáveis.

Uma chave de API de IA deve identificar o limite de uma carga de trabalho, e não uma organização inteira para sempre. Chaves separadas facilitam o controle de acesso, cota, roteamento, rotação e registros de uso, sem expor uma única credencial em aplicações sem relação entre si.
As chaves de API do Modelflare podem combinar data de expiração, cota limitada ou ilimitada, limites de modelos, lista de IPs permitidos e política de roteamento. Esses controles são mais eficazes quando planejados em conjunto, e não adicionados apenas depois de um incidente.
Comece com uma chave por carga de trabalho
Crie chaves separadas para os limites que precisam de acesso ou contabilização independentes, como:
- API de produção e workers em segundo plano;
- desenvolvimento e CI;
- um agente de programação ou uma ferramenta local;
- uma aplicação voltada para clientes;
- um prestador de serviços temporário ou uma migração;
- uma carga de trabalho em lote de alto custo.
Use nomes que descrevam o ambiente e a finalidade, como prod-support-agent ou dev-evaluation. Um nome claro torna compreensíveis os registros de solicitações e as decisões de rotação, sem revelar o segredo.
Mantenha o segredo fora do código visível no cliente
Armazene a chave completa em um gerenciador de segredos no servidor ou em uma variável de ambiente protegida. Não a coloque em:
- JavaScript do navegador ou pacotes de apps móveis que os usuários podem inspecionar;
- controle de versão, imagens de contêiner, capturas de tela ou tickets;
- eventos de analytics, ferramentas de rastreamento de erros, histórico do shell ou logs da aplicação;
- URLs, query strings ou exemplos de comandos copiados com valores reais.
Em uma aplicação de navegador, envie as solicitações por um backend que autentique o usuário e guarde a chave do Modelflare. Se uma chave puder ter vazado, crie uma substituta, migre a carga de trabalho, verifique o tráfego na nova chave e revogue a antiga.
Use cota e expiração como limites independentes
Uma cota limitada impõe um teto rígido de uso para aquela chave. Uma data de expiração limita por quanto tempo a credencial continua válida. Elas tratam riscos diferentes:
| Controle | Finalidade principal |
|---|---|
| Cota limitada | Limita o volume de uso atribuível à chave |
| Cota ilimitada | Evita um teto no nível da chave; os créditos da conta e as demais políticas continuam valendo |
| Expiração | Encerra o acesso depois de um prazo definido |
| Desativar ou revogar | Interrompe imediatamente novos acessos |
Chaves de desenvolvimento, de prestadores de serviços e de avaliação normalmente devem ter cota limitada e expiração. Chaves de produção podem precisar de uma cota maior ou ilimitada, mas ainda se beneficiam da atribuição separada por carga de trabalho e de um plano de rotação.
A cota não substitui limites de concorrência nem o controle de novas tentativas no cliente. Um pico pode consumir rapidamente o valor restante, e falhas repetidas podem gerar solicitações adicionais.
Restrinja os modelos quando a carga de trabalho for específica
Os limites de modelos impedem que uma chave solicite modelos fora do conjunto previsto. Isso reduz o uso acidental de um modelo incompatível ou inesperadamente caro e cria uma fronteira 403 mais clara quando o cliente pede algo que não deveria acessar.
Mantenha o conjunto permitido alinhado ao endpoint. Uma chave que consegue listar um modelo ainda precisa de um cliente e de um protocolo que suportem o formato de solicitação desse modelo. Revise o contrato atualizado em Modelos e preços, em vez de copiar IDs de modelos para um documento de política de longa duração.
Adicione regras de IP somente quando o caminho de rede for estável
Uma lista de IPs permitidos compara o IP do cliente observado pelo Modelflare com os endereços individuais ou intervalos CIDR configurados na chave. Ela é útil para servidores com saída de rede conhecida, mas pode interromper o tráfego quando:
- uma carga de trabalho na nuvem muda os endereços de NAT de saída;
- as solicitações passam por um novo proxy ou gateway;
- os caminhos IPv4 e IPv6 são diferentes;
- um desenvolvedor troca de rede;
- o CIDR configurado é mais amplo ou mais restrito do que o pretendido.
Verifique o caminho real de saída antes de ativar a restrição, mantenha um caminho de rotação emergencial e não trate a lista de IPs permitidos como substituta da proteção do segredo.
Escolha entre roteamento comum e inteligente de forma intencional
| Tipo de chave | Comportamento de roteamento | Melhor uso |
|---|---|---|
| Chave de API comum | Um grupo principal explícito, mais grupos de contingência ordenados opcionais | Cargas de trabalho que exigem uma ordem de rotas e uma política de grupos conhecidas |
| Chave de API inteligente (Smart API Key) | Avalia os grupos elegíveis da conta com a estratégia equilibrada, de prioridade à estabilidade ou de prioridade ao menor preço | Cargas de trabalho que querem uma seleção automática de rotas mais ampla |
Os dois tipos de chave continuam enviando o modelo e o protocolo solicitados. A política de roteamento escolhe um grupo elegível; ela não garante que todos os grupos ofereçam suporte a todos os modelos ou recursos. Uma lista de contingência comum deve ser testada na ordem definida. Uma chave de API inteligente deve ser avaliada com requisitos reais de latência, preço e compatibilidade antes de ir para produção.
Para conhecer o comportamento em detalhes, leia Roteamento confiável de API de IA.
Faça a rotação sem uma interrupção evitável
Use uma rotação com sobreposição:
- Crie uma nova chave com as mesmas restrições pretendidas.
- Armazene-a no sistema de segredos da aplicação.
- Implante a nova credencial sem excluir a antiga.
- Verifique o acesso aos modelos e uma solicitação real.
- Confirme que novos registros de uso aparecem associados à nova chave.
- Remova a chave antiga de todas as implantações e tarefas de automação.
- Desative ou exclua a chave antiga.
- Monitore solicitações inesperadas que usem a credencial desativada.
Se houver um comprometimento em andamento, revogue primeiro e aceite a interrupção controlada. O procedimento com sobreposição serve para rotações planejadas, e não para prolongar uma exposição.
Conecte a política de chaves à revisão de custos
O isolamento por chave torna a revisão de custos acionável. Filtre os registros de uso por chave e compare modelo, grupo, uso de entrada e de saída, status, novas tentativas e custo. Uma cota limitada pode impedir o uso adicional, mas são os registros de solicitações que explicam o que a consumiu.
Consulte Rastreamento de custos de API de IA para um processo de revisão repetível.
Checklist de chaves de API
- Uma chave por aplicação, ambiente ou carga de trabalho com responsável definido.
- Nenhum segredo em código de navegador, repositórios, logs, URLs ou capturas de tela.
- Cota limitada e expiração para uso temporário ou experimental.
- Restrições de modelos para cargas de trabalho específicas.
- Regras de IP somente para um caminho de saída verificado e estável.
- Ordem de contingência comum explícita ou uma estratégia inteligente escolhida de forma intencional.
- Rotação testada antes de remover a chave antiga.
- Uso e custo revisados por chave depois de cada mudança de política.
Perguntas frequentes
Uma chave ilimitada remove todos os limites de gastos?
Não. Ela remove apenas o teto de cota no nível da chave. Os créditos da conta, os preços dos modelos, a política de grupos, os limites de solicitações e os demais controles do serviço continuam valendo.
Várias chaves conseguem contornar um limite de taxa?
Não necessariamente. Um limite pode ser aplicado no nível da conta, do grupo de modelos ou da rota. Crie chaves para controlar acesso e atribuição, e não como uma solução não verificada para limites de taxa.
Uma lista de IPs permitidos basta se uma chave vazar?
Não. As regras de rede reduzem os lugares onde uma chave pode ser usada, mas os caminhos de rede mudam e a configuração pode estar errada. Faça a rotação das credenciais expostas e mantenha o segredo protegido em repouso e na implantação.