Source: https://aiprimetech.io/pt/docs/getting-started/authentication/

[Início](/pt/) / [Documentação](/pt/docs/) / Autenticação 

# Autenticação 

Como enviar sua chave, qual cabeçalho cada formato espera e como manter as chaves seguras. 

 Copiar página [ Ver como Markdown](/pt/docs/getting-started/authentication.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/authentication.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/authentication.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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: 

```
Copy-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 .env para .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. 

[Início rápidoFazer a primeira chamada](/pt/docs/getting-started/quickstart/)[Configuração da chave de APIOnde inserir a chave em cada ferramenta](/pt/docs/guides/api-key-configuration/)[ErrosO que significa um 401 em comparação com um 402](/pt/docs/api-reference/errors/) 

[AnteriorInício rápido](/pt/docs/getting-started/quickstart/)[PróximoModelos e grupos de chaves](/pt/docs/getting-started/models/)