Autenticação
Todos os endpoints, exceto GET /v1/models, exigem uma chave de API. Envie-a em um destes cabeçalhos. Os dois funcionam em todos os endpoints; então use o que seu cliente enviar:
Authorization: Bearer $YOUR_KEY, que os SDKs da OpenAI e a maioria das ferramentas enviam.x-api-key: $YOUR_KEY, que os SDKs da Anthropic enviam.
Marcadores:
$API_BASEéhttps://api.abliteratedllm.dev/v1,$API_ORIGINéhttps://api.abliteratedllm.deve$YOUR_KEYé sua chave de API.
# OpenAI style
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"
# Anthropic style
curl $API_BASE/balance -H "x-api-key: $YOUR_KEY"Chaves de API
Crie, renomeie, edite e revogue chaves em Chaves de API, que também mostra quando cada chave foi usada pela última vez (com precisão de alguns minutos) e quanto ela já gastou.
- Uma chave é
sk-seguido de 48 letras e dígitos. - Ela é exibida uma única vez, quando você a cria. Armazenamos apenas um hash com chave dela; por isso, não podemos exibi-la novamente. O painel identifica as chaves pelos 10 primeiros caracteres.
- Uma conta pode ter até 20 chaves ativas. Revogue uma para abrir espaço para outra.
- A criação de chaves é limitada a 30 tentativas por hora por conta. As tentativas seguintes recebem 429
rate_limit_exceededcom um cabeçalhoRetry-After. - A revogação de uma chave entra em vigor em até 30 segundos.
- Uma chave pode ter uma data de expiração. Ela para de funcionar às 00:00 UTC dessa data, e as requisições passam a receber 401
invalid_api_keycom a mensagemThis API key expired on 2026-12-31 00:00 UTC.Enquanto não revogar a chave expirada, você pode definir uma data posterior para voltar a usá-la. - O Playground usa uma chave própria, que é gerenciada para você e não aparece na lista.
Tetos de gastos
Cada chave pode ter um teto diário, um teto mensal e um orçamento total, em qualquer combinação. Dias e meses seguem o UTC; o orçamento total conta o que a chave gastou desde que os orçamentos totais foram introduzidos (para chaves mais antigas, apenas os últimos 30 dias de uso antes disso). Antes de uma requisição ser encaminhada, seu custo máximo possível (a reserva descrita em Limites de requisições e teste grátis) é somado ao que a chave já gastou no período. Se esse total ultrapassar um teto, a requisição falha com 402 key_spend_cap_reached e nada é cobrado; a mensagem indica o teto (diário, mensal ou total). Os tetos são uma boa forma de dar a um script ou a um colega de equipe uma chave com orçamento fixo. GET /v1/balance informa quanto resta de cada um.
Número da conta e chaves de API são coisas separadas
Seu número de conta de 16 dígitos serve para entrar no site. Ele nunca funciona como chave de API, e uma chave de API não serve para entrar no site. Mantenha os dois em segredo: quem tiver o número da conta controla a conta e o crédito dela.
Erros
O status da conta é verificado antes de qualquer outra coisa na requisição.
| Status | Código | Significado |
|---|---|---|
| 401 | invalid_api_key | Nenhuma chave foi enviada, ou a chave está malformada, é desconhecida, foi revogada ou expirou. |
| 403 | account_suspended | A conta está suspensa. Todas as chaves dela são recusadas até o fim da suspensão. |
| 403 | account_banned | A conta foi banida. As chaves dela são revogadas e o crédito restante é perdido. |
A lista completa está na página Erros.
IDs de requisição
Toda resposta, inclusive as de erro, traz um cabeçalho x-request-id. Informe-o quando entrar em contato com o suporte ou relatar um problema. Com ele, encontramos os metadados da requisição (horário, chave, modelo, contagens de tokens, custo, status e latência), que mantemos por 30 dias. Não armazenamos prompts nem respostas (veja a política de privacidade); então o ID da requisição é a única forma de apontar uma requisição específica.