Анатомия первого запроса

Три обязательных поля

Тело запроса — это JSON с тремя обязательными полями:

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "Сделай вежливый ответ клиенту: где мой заказ?"}
  ]
}

• model — какую модель звать (точная строка, без выдуманных дат — об этом отдельный урок).
• max_tokens — потолок длины ответа в токенах. Поле обязательное. Поставишь слишком мало — ответ оборвётся на полуслове.
• messages — список сообщений диалога. Каждое — объект с role (user или assistant) и content (текст).

Необязательный system

Есть ещё system — это инструкция верхнего уровня, которая задаёт роль и правила поведения модели. Она лежит рядом с messages, а не внутри них:

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "system": "Ты — оператор поддержки интернет-магазина. Отвечай кратко и вежливо.",
  "messages": [
    {"role": "user", "content": "Где мой заказ №1542?"}
  ]
}

Что вернёт сервер

По такому запросу сервер пришлёт JSON с ответом ассистента: текст внутри массива content, причину остановки stop_reason и счётчики токенов usage. Разберём ответ детально в следующем уроке.