Разбор первого запроса

Построчный разбор одного вызова Messages — назначение каждого поля и содержимое ответа.

Краткое руководство позволяет получить ответ. Эта страница объясняет значение каждой части запроса, чтобы следующий запрос вы могли написать самостоятельно.

Запрос

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

Ответ

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 — это массив, а не строка. Текст находится в content[0].text. Обработка этого значения как строки — самая распространённая ошибка в клиенте.
• stop_reason показывает, почему завершилась генерация: end_turn (завершена), max_tokens (достигнут заданный вами предел — ответ обрезан), stop_sequenceили tool_use.
• usage — это то, на основании чего вам выставляют счёт. Записывайте это значение в журнал: это единственная надёжная основа для распределения затрат.

Многоходовые разговоры

API не сохраняет состояние. Чтобы продолжить разговор, нужно повторно отправить всю историю, включая предыдущие ответы модели:

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