---
title: "Interface nativa de conversa Messages"
description: "Cabeçalhos de requisição do Claude Messages, diferenças entre system e messages, blocos de conteúdo e motivos de término."
headingIds: {"Requisição mínima":"section-1","Estrutura da requisição":"section-2","Lendo blocos de conteúdo":"section-3","Múltiplas rodadas e streaming":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Claude Code, o SDK da Anthropic e aplicações que desejam preservar os blocos de conteúdo nativos do Claude usam `POST https://1zheai.com/v1/messages`. Preencha a Base URL do SDK com `https://1zheai.com`.

## Requisição mínima

Primeiro defina a variável de ambiente da chave deste site `ONEZHE_API_KEY` e depois execute:

```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
  https://1zheai.com/v1/messages \
  -H "x-api-key: $ONEZHE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "system": "请用简短的中文回答。",
    "messages": [{"role": "user", "content": "什么是域名解析？"}]
  }'
```

## Estrutura da requisição

| Campo | Tipo | Como usar |
| --- | --- | --- |
| `model` | string | Obrigatório, seleciona o modelo Claude disponível para a chave |
| `max_tokens` | integer | Obrigatório, limite máximo de saída; defina combinando com as restrições do modelo selecionado |
| `messages` | array | Obrigatório, envia mensagens `user` e `assistant` em ordem cronológica |
| `system` | string ou array de blocos de conteúdo | Opcional, instruções do sistema ficam no nível superior, sem usar mensagens `role: system` |
| `stream` | boolean | Opcional, lê os incrementos dos blocos de conteúdo em streaming |
| `tools` | array | Opcional, declara nome, propósito e Schema de entrada das ferramentas |

`thinking`, controle de cache e parâmetros beta dependem do modelo específico e do suporte do upstream. Valide primeiro texto simples e adicione conforme necessário; não trate todos os modelos como o mesmo conjunto de parâmetros.

## Lendo blocos de conteúdo

O `content` retornado é um array e pode conter texto, solicitações de ferramenta ou outros blocos de conteúdo ao mesmo tempo. Não leia `content[0].text` incondicionalmente. Por exemplo, usando o SDK Python da Anthropic:

```python
for block in message.content:
    if block.type == "text":
        print(block.text)
```

Aqui o `message` vem de `client.messages.create(...)` no [tutorial do SDK da Anthropic](/pt/docs/quickstart-anthropic-sdk/).

| `stop_reason` | Como a aplicação deve tratar |
| --- | --- |
| `end_turn` | A resposta desta rodada terminou |
| `max_tokens` | A saída foi truncada pelo limite máximo e não pode ser tratada como resposta completa |
| `tool_use` | Verifique as solicitações de ferramenta, execute as ferramentas permitidas e devolva os resultados |
| Outros valores | Preserve a resposta e trate conforme o protocolo do modelo selecionado; não assuma que é necessariamente conclusão de texto |

No ciclo de chamadas de ferramenta, primeiro adicione o bloco de conteúdo completo do assistant ao histórico e depois devolva com `tool_result` no conteúdo do user; `tool_use_id` deve corresponder à requisição original. Não converta solicitações de ferramenta diretamente em um texto simples.

## Múltiplas rodadas e streaming

Envie o histórico necessário a cada requisição; a interface em si não armazena a conversa para a aplicação. O streaming indica o fim da mensagem com `message_stop`; receber texto parcial não significa que a requisição já foi concluída. Veja [saída em streaming](/pt/docs/streaming/).

Para detalhes do protocolo, consulte [instruções de uso do Anthropic Messages](https://platform.claude.com/docs/en/build-with-claude/working-with-messages). A disponibilidade dos parâmetros estendidos deste site depende do catálogo de modelos e da resposta real.