Chave de API
Uma chave de API (API key) é uma string secreta que uma aplicação envia com cada requisição para que um serviço saiba qual conta está chamando, aplique seus limites e faça a cobrança. Quem tem a chave geralmente consegue usá-la.
Também chamado: API token, secret key
Por Divya Sharma · Verificado em 15 de nov. de 2026 · Como analisamos
Quase todo modelo hospedado, dos grandes laboratórios aos provedores de inferência, é acessado com uma chave de API. Você a cria no console do provedor e a envia em um cabeçalho da requisição. O provedor a usa para encontrar sua conta, aplicar seus rate limits e cobrar seu uso pelos preços por token.
O que uma chave prova e o que não prova
Uma chave de API básica identifica um projeto ou uma conta, não uma pessoa. A documentação do Google diz isso diretamente: uma chave padrão não autentica um principal. Quem tem a string pode gastar o seu dinheiro e, dependendo do serviço, ler os seus dados. Isso torna a chave mais parecida com uma senha do que com um nome de usuário.
Mantendo as chaves seguras
Guarde as chaves no servidor, em variáveis de ambiente ou em um gerenciador de segredos, e nunca em código de front-end, apps móveis ou um repositório público. Use chaves separadas por ambiente ou projeto, para que uma possa ser revogada sem quebrar o resto. Quando o provedor permitir, restrinja a chave a certas APIs, endereços IP ou workspaces, defina uma data de expiração e um limite de gastos. O Google alerta que chaves sem restrição são inseguras. Faça a rotação de qualquer chave que possa ter vazado.
Chaves de API e agentes
Agentes de programação e servidores MCP muitas vezes precisam de chaves para as ferramentas que chamam. Passar uma chave de longa duração para o contexto ou a configuração de um agente dá ao agente, e a qualquer coisa que consiga injetar um prompt nele, o mesmo poder. Tokens delegados e com escopo, por meio de OAuth, são o padrão mais seguro quando o serviço os oferece. Um LLM gateway também pode guardar as chaves dos provedores de forma centralizada e distribuir chaves próprias com limites mais rígidos.
Termos relacionados
- OAuth para agentes de IA
- OAuth para agentes de IA é o uso do padrão de autorização OAuth para permitir que um agente ou cliente MCP aja em nome de um usuário com um token de acesso limitado e revogável, em vez de guardar a senha do usuário ou uma API key ampla.
- Rate limit (API)
- Um rate limit (limite de taxa) restringe quanto uma conta pode usar uma API em uma janela de tempo, normalmente em requisições por minuto (RPM) e tokens por minuto (TPM). Requisições acima do limite são rejeitadas, geralmente com um erro HTTP 429.
- LLM gateway
- Um LLM gateway (gateway de LLMs) é um servidor proxy entre as suas aplicações e os provedores de modelos que expõe uma única API e cuida de chaves, roteamento, fallbacks, rate limits, logs e controle de gastos em um só lugar.
- Preço por token
- O preço por token (token pricing) é a forma como a maioria das APIs de modelos de IA cobra: um preço fixo por milhão de tokens de entrada que você envia e um preço separado, geralmente mais alto, por milhão de tokens de saída que o modelo gera, com descontos para entrada em cache e jobs em lote.
- Prompt injection
- Prompt injection (injeção de prompt) é um ataque em que um texto enviado a um modelo de linguagem, digitado por um usuário ou escondido em uma página web, arquivo ou resultado de ferramenta, muda o comportamento do modelo de formas que o desenvolvedor não pretendia.