Documentação da API

Comece pela sua chave

Abra Minhas chaves, clique em Mostrar chave e copie seu acesso ctg_. Nos exemplos, substitua SUA_CHAVE_CTG pela sua chave. Não publique a chave em sites, repositórios ou código executado no navegador.

Consulte os modelos disponíveis e seus identificadores em Consultar consumo. Os nomes utilizados abaixo são exemplos; escolha um modelo habilitado na sua chave.

Endereço correto para cada ferramenta

Anthropic / Claude

https://contigencia.com.br — sem /v1; a ferramenta acrescenta o caminho.

OpenAI compatível

https://contigencia.com.br/v1

Endpoint completo de mensagens

https://contigencia.com.br/v1/messages

Autenticação: cabeçalho x-api-key ou Authorization: Bearer, usando sua chave ctg_. Todas as chamadas devem usar HTTPS.

Claude Code

Com Claude Code instalado, configure as variáveis no terminal em que vai executá-lo. Abra uma nova sessão após mudar a configuração.

$env:ANTHROPIC_BASE_URL="https://contigencia.com.br"
$env:ANTHROPIC_AUTH_TOKEN="SUA_CHAVE_CTG"
claude --model claude-sonnet-5

export ANTHROPIC_BASE_URL="https://contigencia.com.br"
export ANTHROPIC_AUTH_TOKEN="SUA_CHAVE_CTG"
claude --model claude-sonnet-5

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://contigencia.com.br",
    "ANTHROPIC_AUTH_TOKEN": "SUA_CHAVE_CTG"
  }
}

Não substitua outras preferências do seu arquivo. O saldo desta API é separado de assinaturas do aplicativo Claude.

Cline, Roo Code e outros clientes

Escolha o provedor Anthropic e informe a URL base acima, a chave ctg_ e um modelo disponível. Se o cliente oferecer apenas OpenAI compatível, use a base terminada em /v1. A ferramenta precisa permitir alterar a URL base.

Endpoints disponíveis

• POST /v1/messages — mensagens Anthropic, streaming e ferramentas.
• POST /v1/messages/count_tokens — contagem de entrada.
• POST /v1/chat/completions — formato OpenAI Chat Completions.
• POST /v1/responses — formato Responses.
• GET /v1/models — modelos da sua chave.

Exemplos HTTP — terminal macOS / Linux

curl "https://contigencia.com.br/v1/models" -H "Authorization: Bearer SUA_CHAVE_CTG"

curl "https://contigencia.com.br/v1/messages" \
  -H "x-api-key: SUA_CHAVE_CTG" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":128,"messages":[{"role":"user","content":"Olá"}]}'

curl "https://contigencia.com.br/v1/chat/completions" \
  -H "Authorization: Bearer SUA_CHAVE_CTG" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","max_tokens":128,"messages":[{"role":"user","content":"Olá"}]}'

curl "https://contigencia.com.br/v1/responses" \
  -H "Authorization: Bearer SUA_CHAVE_CTG" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","max_output_tokens":128,"input":"Olá"}'

Para streaming, acrescente "stream": true ao JSON e use curl -N. Mensagens e definições de ferramentas seguem o formato do endpoint escolhido.

Saldo e solução de problemas

O consumo depende dos pesos de entrada, saída e cache de cada modelo. Consulte os valores no painel; saldo não representa necessariamente a mesma quantidade de tokens brutos em todos os modelos.

• 401: confira a chave, suspensão e validade.
• 403: confira a situação do pedido vinculado.
• 429: confira saldo e limites. São até 3 chamadas simultâneas e 60 por minuto por chave.
• 400: confira o modelo e o formato dos parâmetros.
• 502 ou transmissão interrompida: consulte o consumo antes de reenviar; a chamada pode ter consumido saldo.

Limite de duração: 5 minutos por chamada. Pacotes adicionais são liberados pela equipe em chaves separadas.