Autenticação
Como enviar sua chave, qual cabeçalho cada formato espera e como manter as chaves seguras.
Toda solicitação precisa de uma chave de API criada no seu painel. As chaves começam com sk- e têm as permissões e o saldo da conta que as criou.
Dois cabeçalhos, uma chave
A mesma chave funciona nos dois formatos — apenas o nome do cabeçalho muda.
| Formato | Endpoint | Cabeçalho |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
O formato da Anthropic também exige um cabeçalho de versão. Qualquer SDK da Anthropic o define automaticamente:
-H "anthropic-version: 2023-06-01"Variáveis de ambiente
A maioria das ferramentas lê estas variáveis em vez de receber uma chave como argumento:
| Variável | Usada por | Valor |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code, SDK da Anthropic | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | seu sk- chave |
ANTHROPIC_API_KEY | SDK da Anthropic (Python/TS) | seu sk- chave |
OPENAI_BASE_URL | SDK da OpenAI, LangChain, LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | SDK da OpenAI | seu sk- chave |
Observe o campo
/v1 sufixo em OPENAI_BASE_URL mas não em ANTHROPIC_BASE_URL. Essa assimetria está nos SDKs oficiais, não é algo que introduzimos — o cliente da OpenAI acrescenta caminhos à base que você fornece, enquanto o cliente da Anthropic acrescenta /v1 por conta própria. Errar isso é o problema de configuração mais comum.Boas práticas para chaves
- Crie uma uma chave separada por máquina ou projeto para que uma possa ser revogada sem afetar as outras.
- Nunca inclua chaves em commits. Use variáveis de ambiente ou um gerenciador de segredos; adicione
.envpara.gitignore. - As chaves são exibidas por completo uma única vez. Substitua uma chave perdida em vez de tentar recuperá-la.
- Uma chave vazada consome seu saldo. Revogue-a imediatamente no painel — a revogação é instantânea.
- Prefira chamadas do lado do servidor. Uma chave incluída em um pacote de navegador ou aplicativo móvel é uma chave pública.
Revogação e substituição
- Painel → Chaves de API.
- Crie primeiro a chave substituta e coloque-a em uso.
- Exclua a chave antiga depois que o tráfego tiver sido transferido. Solicitações em andamento que a utilizem falham imediatamente após a exclusão.