Acessando a API

A API está disponível através do nosso Console na web. Você pode usar o Workbench para testar a API no navegador e depois gerar chaves de API em Configurações da Conta. Use workspaces para segmentar suas chaves de API e controlar gastos por caso de uso.

Autenticação

Todas as requisiçõ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ê configurará a API ao construir um cliente, e então o SDK enviará o cabeçalho em seu nome com cada requisição. Se estiver integrando diretamente com a API, você precisará enviar este cabeçalho por conta própria.

Tipos de conteúdo

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

Cabeçalhos de Resposta

A API da Anthropic inclui os seguintes cabeçalhos em cada resposta:

  • request-id: Um identificador globalmente único para a requisição.

  • anthropic-organization-id: O ID da organização associado à chave de API usada na requisiçã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-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

Was this page helpful?