Главная / Документация / API сообщений

API сообщений

POST /v1/messages — эндпоинт в формате Anthropic: параметры, структура ответа и примеры.

Посмотреть в формате Markdown Спросить ChatGPT Спросить в Claude

Конечная точка, которую используют все клиенты, совместимые с Anthropic, включая Claude Code и официальные SDK.

ЭндпоинтPOST https://aiprimetech.io/v1/messages

Аутентификацияx-api-key: sk-...

Заголовок версииanthropic-version: 2023-06-01

Тип содержимогоapplication/json

Тело запроса

Поле	Тип	Обязательно	Описание
`model`	строка	да	Идентификатор модели в точности как в списке `/v1/models`
`messages`	массив	да	Чередующиеся сообщения пользователя и ассистента, начиная с самого раннего
`max_tokens`	целое число	да	Максимальное количество выходных токенов. При достижении этого предела генерация останавливается.
`system`	строка или массив	нет	Системный промпт верхнего уровня. Не роль сообщения.
`temperature`	число	нет	0–1. Не указывайте, чтобы использовать значение модели по умолчанию.
`top_p`	число	нет	Выборка по совокупной вероятности. Используйте либо её, либо температуру, но не оба параметра одновременно.
`stop_sequences`	массив	нет	Строки, при появлении которых генерация останавливается
`stream`	логическое значение	нет	true для событий, отправляемых сервером
`tools`	массив	нет	Определения инструментов — см. Использование инструментов
`metadata`	объект	нет	Передаётся без изменений; `user_id` полезно для вашей собственной атрибуции

Пример

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

Ответ

{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

Поле	Описание
`content`	Массив блоков. Текстовые блоки содержат `type: text` и `text` поле; вызовы инструментов содержат `type: tool_use`.
`stop_reason`	`end_turn`, `max_tokens`, `stop_sequence` или `tool_use`
`usage.input_tokens`	Оплачиваемые входные токены, включая всю повторно отправленную историю
`usage.output_tokens`	Оплачиваемые выходные токены — обычно по тарифу в 4–5 раза выше тарифа на входные

Системные промпты

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}

Стабильный system блок идеально подходит для кэширование промптов — он одинаков при каждом вызове, поэтому его можно читать из кеша за небольшую долю стоимости входных токенов.

Мультимодальный ввод

Блоки изображений используют стандартную структуру Anthropic — см. Работа с изображениями.

Потоковая передачаВывод по токенам Использование инструментовВызов функций ОшибкиВозможные сбои