Source: https://aiprimetech.io/ru/docs/api-reference/messages/

[Главная](/ru/) / [Документация](/ru/docs/) / API сообщений 

# API сообщений 

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

 Копировать страницу [ Посмотреть в формате Markdown](/ru/docs/api-reference/messages.md) [ Спросить ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Спросить в Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

Конечная точка, которую используют все клиенты, совместимые с 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 | массив | нет | Определения инструментов — см. [Использование инструментов](/ru/docs/api-reference/tool-use/)

 | metadata | объект | нет | Передаётся без изменений; user_id полезно для вашей собственной атрибуции 

## Пример 

```
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": "..."}],
  "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 раза выше тарифа на входные 

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

```
Copy{
  "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 блок идеально подходит для [кэширование промптов](/ru/docs/guides/prompt-caching/) — он одинаков при каждом вызове, поэтому его можно читать из кеша за небольшую долю стоимости входных токенов. 

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

Блоки изображений используют стандартную структуру Anthropic — см. [Работа с изображениями](/ru/docs/api-reference/vision/). 

[Потоковая передачаВывод по токенам](/ru/docs/api-reference/streaming/)[Использование инструментовВызов функций](/ru/docs/api-reference/tool-use/)[ОшибкиВозможные сбои](/ru/docs/api-reference/errors/) 

[НазадОбзор API](/ru/docs/api-reference/overview/)[ДалееAPI генерации ответов в чате](/ru/docs/api-reference/chat-completions/)