Primeiros passosAutenticação

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.dev e $YOUR_KEY é sua chave de API.

bash
# 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_exceeded com um cabeçalho Retry-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_key com a mensagem This 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.

StatusCódigoSignificado
401invalid_api_keyNenhuma chave foi enviada, ou a chave está malformada, é desconhecida, foi revogada ou expirou.
403account_suspendedA conta está suspensa. Todas as chaves dela são recusadas até o fim da suspensão.
403account_bannedA 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.