Visão Geral

​

Acessando a API

A API é disponibilizada através do nosso Console web. Você pode usar o Workbench para testar 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 da Anthropic 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 da Anthropic 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:

• Endpoints padrão (Mensagens, Contagem de Tokens): 32 MB
• API de Lote: 256 MB
• API de Arquivos: 500 MB

​

Cabeçalhos de Resposta

A API da Anthropic 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

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-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

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-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

pip install anthropic

import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // defaults to process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-opus-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);