Giải thích yêu cầu đầu tiên của bạn

Hướng dẫn từng dòng của một lệnh gọi Messages — chức năng của từng trường và dữ liệu trả về.

Hướng dẫn bắt đầu nhanh giúp bạn nhận được phản hồi. Trang này giải thích ý nghĩa của từng phần để bạn có thể tự viết yêu cầu tiếp theo.

Yêu cầu

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"}]
  }'

Phản hồi

Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "Hello! How can I help?"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

• content là một mảng, không phải một chuỗi. Văn bản nằm tại content[0].text. Xử lý nó như một chuỗi là lỗi phổ biến nhất ở ứng dụng khách.
• stop_reason cho biết lý do quá trình sinh kết thúc: end_turn (đã hoàn tất), max_tokens (đã chạm giới hạn bạn đặt — câu trả lời bị cắt ngắn), stop_sequence, hoặc tool_use.
• usage là căn cứ tính phí cho bạn. Hãy ghi lại giá trị này; đây là cơ sở đáng tin cậy duy nhất để phân bổ chi phí.

Hội thoại nhiều lượt

API không lưu trạng thái. Để tiếp tục cuộc hội thoại, bạn gửi lại toàn bộ lịch sử, bao gồm các câu trả lời trước đó của mô hình:

Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"},
    {"role": "assistant", "content": "Paris."},
    {"role": "user", "content": "And its population?"}
  ]
}