Anthropic Messages

Envie uma requisição HTTP no formato Anthropic Messages. Para configurar o Claude Code, consulte os guias relacionados.

Antes de começar

Siga o guia rápido para obter a chave e escolher um endpoint que aceite chamadas HTTP diretas. O exemplo envia ICODEEASY_API_KEY no cabeçalho x-api-key e inclui anthropic-version. Troque YOUR_MODEL_ID pelo ID de um modelo aceito pelo endpoint.

Exemplo de requisição

Informe model, limite a saída com max_tokens e inclua a conversa em messages.

curl -sS https://api.icodeeasy.cc/v1/messages \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "YOUR_MODEL_ID",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Say hello."
    }
  ]
}'

Leia a resposta

Leia os blocos do tipo text em content[]. Consulte usage.input_tokens e usage.output_tokens para obter o uso. Quando presentes, cache_creation_input_tokens e cache_read_input_tokens contam gravações e leituras de cache, respectivamente.

{
  "content": [
    {
      "type": "text",
      "text": "Hello!"
    }
  ],
  "stop_reason": "end_turn"
}

Exemplo de resposta em streaming

Defina stream: true no corpo da requisição para receber SSE. Junte delta.text dos eventos content_block_delta. Leia o motivo de término em message_delta e confirme o fim em message_stop. Trate um evento SSE error como falha, mesmo se o HTTP já retornou 200.

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Hello!"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"output_tokens":4}}

event: message_stop
data: {"type":"message_stop"}

Leia o uso em streaming em message_start.message.usage e nos campos posteriores de message_delta.usage. Os campos de cache têm o mesmo significado que na resposta JSON.