Exemplos de mensagens
Exemplos de requisição e resposta para a API de Mensagens
Consulte a referência da API para documentação completa sobre os parâmetros disponíveis.
Requisição e resposta básica
{
"id": "msg_01XFDUDYJgAACzvnptvVoYEL",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello!"
}
],
"model": "claude-3-5-sonnet-20241022",
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 12,
"output_tokens": 6
}
}
Múltiplos turnos de conversação
A API de Mensagens é stateless, o que significa que você sempre envia o histórico completo da conversação para a API. Você pode usar esse padrão para construir uma conversa ao longo do tempo. Os turnos anteriores da conversação não precisam necessariamente se originar do Claude — você pode usar mensagens sintéticas do assistant
.
#!/bin/sh
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, Claude"},
{"role": "assistant", "content": "Hello!"},
{"role": "user", "content": "Can you describe LLMs to me?"}
]
}'
import anthropic
message = anthropic.Anthropic().messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
messages=[
{"role": "user", "content": "Hello, Claude"},
{"role": "assistant", "content": "Hello!"},
{"role": "user", "content": "Can you describe LLMs to me?"}
],
)
print(message)
import Anthropic from '@anthropic-ai/sdk';
const anthropic = new Anthropic();
await anthropic.messages.create({
model: 'claude-3-5-sonnet-20241022',
max_tokens: 1024,
messages: [
{"role": "user", "content": "Hello, Claude"},
{"role": "assistant", "content": "Hello!"},
{"role": "user", "content": "Can you describe LLMs to me?"}
]
});
{
"id": "msg_018gCsTGsXkYJVqYPxTgDHBU",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Sure, I'd be happy to provide..."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 30,
"output_tokens": 309
}
}
Colocando palavras na boca do Claude
Você pode pré-preencher parte da resposta do Claude na última posição da lista de mensagens de entrada. Isso pode ser usado para moldar a resposta do Claude. O exemplo abaixo usa "max_tokens": 1
para obter uma única resposta de múltipla escolha do Claude.
{
"id": "msg_01Q8Faay6S7QPTvEUUQARt7h",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "C"
}
],
"model": "claude-3-5-sonnet-20241022",
"stop_reason": "max_tokens",
"stop_sequence": null,
"usage": {
"input_tokens": 42,
"output_tokens": 1
}
}
Visão
O Claude pode ler tanto texto quanto imagens nas requisições. Atualmente, suportamos o tipo de fonte base64
para imagens e os tipos de mídia image/jpeg
, image/png
, image/gif
e image/webp
. Consulte nosso guia de visão para mais detalhes.
{
"id": "msg_01EcyWo6m4hyW8KHs2y2pei5",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Esta imagem mostra uma formiga, especificamente uma vista em close-up de uma formiga. A formiga é mostrada em detalhes, com sua cabeça distinta, antenas e pernas claramente visíveis. A imagem está focada em capturar os detalhes e características intrincadas da formiga, provavelmente tirada com uma lente macro para obter uma perspectiva em close-up extremo."
}
],
"model": "claude-3-5-sonnet-20241022",
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 1551,
"output_tokens": 71
}
}
Uso de ferramentas, modo JSON e uso do computador (beta)
Consulte nosso guia para exemplos de como usar ferramentas com a API de Mensagens. Consulte nosso guia de uso do computador (beta) para exemplos de como controlar ambientes de computador desktop com a API de Mensagens.