Início / Documentação / API de mensagens

API de mensagens

POST /v1/messages — o endpoint no formato Anthropic: parâmetros, estrutura da resposta e exemplos.

Ver como Markdown Perguntar ao ChatGPT Perguntar no Claude

O endpoint usado por todos os clientes compatíveis com a Anthropic, incluindo Claude Code e os SDKs oficiais.

EndpointPOST https://aiprimetech.io/v1/messages

Autenticaçãox-api-key: sk-...

Cabeçalho de versãoanthropic-version: 2023-06-01

Tipo de conteúdoapplication/json

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
`model`	string	sim	ID do modelo, exatamente como listado por `/v1/models`
`messages`	array	sim	Turnos alternados de usuário e assistente, com os mais antigos primeiro
`max_tokens`	inteiro	sim	Máximo de tokens de saída. A geração para nesse limite.
`system`	string ou array	não	Prompt de sistema no nível superior. Não é um papel de mensagem.
`temperature`	número	não	0–1. Omita para usar o padrão do modelo.
`top_p`	número	não	Amostragem de núcleo. Use esta opção ou a temperatura, não ambas.
`stop_sequences`	array	não	Strings que interrompem a geração quando produzidas
`stream`	booleano	não	true para eventos enviados pelo servidor
`tools`	array	não	Definições de ferramentas — consulte Uso de ferramentas
`metadata`	objeto	não	Repassado sem alterações; `user_id` é útil para sua própria atribuição

Exemplo

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Resposta

{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

Campo	Descrição
`content`	Array de blocos. Os blocos de texto contêm `type: text` e um campo `text` ; as chamadas de ferramentas contêm `type: tool_use`.
`stop_reason`	`end_turn`, `max_tokens`, `stop_sequence` ou `tool_use`
`usage.input_tokens`	Entrada faturada, incluindo todo o histórico reenviado
`usage.output_tokens`	Saída faturada — normalmente 4–5× a tarifa de entrada

Prompts de sistema

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}

Um bloco estável de system é o alvo ideal para o cache de prompts — ele é idêntico em todas as chamadas, portanto pode ser lido do cache por uma fração do preço de entrada.

Entrada multimodal

Os blocos de imagem usam a estrutura padrão da Anthropic — consulte Visão.

TransmissãoSaída token por token Uso de ferramentasChamada de funções ErrosModos de falha