Source: https://ailoot.ai/docs/pt-pt/keys/
Canonical: https://ailoot.ai/docs/pt-pt/keys/
Language: pt-pt

[Introdução](https://ailoot.ai/docs/pt-pt/) 

# Chaves e endereço da API

[Markdown](https://ailoot.ai/docs/pt-pt/keys/index.md)

Onde obter a chave, que endereço definir nos diferentes SDK e como transmitir a chave.

## [](https://ailoot.ai/docs/pt-pt/keys/#key)Chave de API

A chave é criada na área pessoal em [ailoot.ai](https://ailoot.ai) após o [registo](https://ailoot.ai/register). 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).

Não publique a chave em código, repositórios ou capturas de ecrã. Guarde-a numa variável de ambiente ou num gestor de segredos. Se a chave for exposta, elimine-a na área pessoal e crie uma nova.

## [](https://ailoot.ai/docs/pt-pt/keys/#base-url)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 |

Recebeu 404 logo após configurar? Quase sempre é um problema de endereço: um segmento a mais ou em falta, `/v1`, uma barra duplicada ou `/chat/completions` onde o cliente já o acrescenta automaticamente.

## [](https://ailoot.ai/docs/pt-pt/keys/#auth)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`.

## [](https://ailoot.ai/docs/pt-pt/keys/#env)Variáveis de ambiente

É cómodo criar uma única variável e utilizá-la nas definições de várias aplicações:

```bash
# ~/.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"
```

```powershell
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íveis
```

## [](https://ailoot.ai/docs/pt-pt/keys/#check)Verificação da chave

A forma mais económica de verificar a chave é consultar a lista de modelos: é gratuito.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Ainda tem dúvidas? Envie o Request ID e uma descrição — ajudamos a esclarecer.[Contactar o suporte](mailto:support@ailoot.ai)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.