​
Acessando a API

A API é disponibilizada através do nosso Console web. Você pode usar o Workbench para experimentar a API no navegador e então gerar chaves de API nas Configurações da Conta. Use espaços de trabalho para segmentar suas chaves de API e controlar gastos por caso de uso.

​
Autenticação

Todas as solicitações para a API do Claude devem incluir um cabeçalho x-api-key com sua chave de API. Se você estiver usando os SDKs do Cliente, você definirá a API ao construir um cliente, e então o SDK enviará o cabeçalho em seu nome com cada solicitação. Se integrando diretamente com a API, você precisará enviar este cabeçalho você mesmo.

​
Tipos de conteúdo

A API do Claude sempre aceita JSON nos corpos das solicitações e retorna JSON nos corpos das respostas. Você precisará enviar o cabeçalho content-type: application/json nas solicitações. Se você estiver usando os SDKs do Cliente, isso será cuidado automaticamente.

​
Limites de tamanho de solicitação

A API tem um tamanho máximo de solicitação de 32 MB para endpoints padrão, incluindo a API de Mensagens e API de Contagem de Tokens. Se você exceder este limite, receberá um erro 413 request_too_large do Cloudflare. Endpoints específicos têm limites diferentes:

​
Cabeçalhos de Resposta

A API do Claude inclui os seguintes cabeçalhos em cada resposta:
  • request-id: Um identificador globalmente único para a solicitação.
  • anthropic-organization-id: O ID da organização associado à chave de API usada na solicitação.

​
Exemplos

Shell
curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'