Autenticação
Onde obter a Base URL e como cada protocolo se autentica — Bearer, x-api-key, x-goog-api-key.
Toda chamada precisa de duas coisas: uma chave de API (comprova quem você é) e a Base URL (para onde a requisição vai). Ambas estão disponíveis no console.
Obtendo a Base URL
Faça login no console e abra a janela "Início rápido" em qualquer card de modelo (ou na visão geral da conta). Escolha seu protocolo na lista suspensa e copie a Base URL correspondente.
- Os prefixos de caminho mudam entre protocolos — copie sempre pela janela;
- Os exemplos da documentação usam
https://<your-base-url>; substitua pelo seu endereço real.
Autenticação por protocolo
| Protocolo | Cabeçalhos de autenticação | Observações |
|---|---|---|
| Compatível com OpenAI | Authorization: Bearer YOUR_API_KEY | Funciona com o SDK oficial da OpenAI — defina api_key + base_url |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | O cabeçalho de versão é obrigatório; o SDK o envia automaticamente |
| Gemini | x-goog-api-key: YOUR_API_KEY | O ID do modelo vai direto no caminho da URL |
Erros de autenticação comuns
- 401 Unauthorized: a chave está errada, foi excluída ou expirou. Confira se está usando a chave completa salva na criação, sem espaços ou quebras de linha extras.
- Chave exposta em código de front-end: tudo que está no código do navegador fica visível para todos — chaves pertencem ao seu servidor ou a variáveis de ambiente locais.
- Chaves trocadas: cada chave tem seu próprio limite de gastos; garanta que está usando a chave certa para o ambiente (produção / testes).
Para criar e guardar chaves, veja Criar uma chave de API.