Chaves e endereço da API
MarkdownOnde obter a chave, que endereço definir nos diferentes SDK e como transmitir a chave.
Guia completo
Chave de API
A chave é criada na área pessoal em ailoot.ai após o registo. Tem o formato sk-…. Pode criar várias chaves: uma para o computador de trabalho, outra para o servidor e outra para cada aplicação — assim, é mais fácil revogar uma sem afetar as restantes.
Pode definir para a chave um limite total de despesas, prazo de validade, listas de IP permitidos e bloqueados e limites de despesas em janelas de 5 horas, 1 dia e 7 dias. Quando um limite é atingido, recebe um erro claro: api_key_quota_exhausted (limite total esgotado), usage_limit_reached (janela de despesas da chave esgotada — aguarde a renovação da janela ou aumente o limite), api_key_expired ou permission_denied (por exemplo, pedido proveniente de um IP não permitido).
Endereço da API
Regra principal: para clientes compatíveis com OpenAI, o endereço inclui /v1; para Anthropic e Gemini, não inclui esse segmento.
| Cliente | Endereço de base | Destino do pedido |
|---|---|---|
| OpenAI SDK e compatíveis | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| O cliente pede o endereço completo | https://api.ailoot.ai/v1/chat/completions | conforme indicado |
Como transmitir a chave
O Ailoot aceita a chave em qualquer um dos três cabeçalhos — utilize o que o seu SDK envia:
| Cabeçalho | Quem o envia assim |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, a maioria dos clientes |
x-api-key: sk-… | Anthropic SDK, Claude Code com ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Nos caminhos /v1/… a chave no endereço (?key= ou ?api_key=) não é aceite: o pedido recebe 400 com o código invalid_request e uma mensagem a indicar que a chave foi transmitida no endereço. Assim, a chave não fica nos registos nem no histórico do navegador. Se a chave já tiver sido utilizada num endereço, é preferível criar uma nova.
Nos caminhos Gemini /v1beta/… é aceite, para compatibilidade com o Google, ?key= — com a prioridade mais baixa, depois dos cabeçalhos. ?api_key= também é rejeitado com 400 nesses caminhos. Ainda assim, é mais fiável transmitir a chave no cabeçalho x-goog-api-key.
Variáveis de ambiente
É cómodo criar uma única variável e utilizá-la nas definições de várias aplicações:
# ~/.zshrc ou ~/.bashrc
export AILOOT_API_KEY="sk-..."
# para programas que leem os nomes padrão
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# para programas que leem os nomes padrão
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# reinicie o terminal para que as variáveis fiquem disponíveisVerificação da chave
A forma mais económica de verificar a chave é consultar a lista de modelos: é gratuito.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"