Source: https://aiprimetech.io/pt/docs/api-reference/messages/

[Início](/pt/) / [Documentação](/pt/docs/) / API de mensagens 

# API de mensagens 

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

 Copiar página [ Ver como Markdown](/pt/docs/api-reference/messages.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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](/pt/docs/api-reference/tool-use/)

 | metadata | objeto | não | Repassado sem alterações; user_id é útil para sua própria atribuição 

## Exemplo 

```
Copycurl 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 

```
Copy{
  "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 

```
Copy{
  "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](/pt/docs/guides/prompt-caching/) — 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](/pt/docs/api-reference/vision/). 

[TransmissãoSaída token por token](/pt/docs/api-reference/streaming/)[Uso de ferramentasChamada de funções](/pt/docs/api-reference/tool-use/)[ErrosModos de falha](/pt/docs/api-reference/errors/) 

[AnteriorVisão geral da API](/pt/docs/api-reference/overview/)[PróximoAPI de conclusões de chat](/pt/docs/api-reference/chat-completions/)