Anthropic Messages

Отправляйте сообщения и Content Blocks в структуре, совместимой с Anthropic Messages.

API Messages создаёт ответы модели с помощью сообщений user, assistant и Content Blocks, поддерживая текст, изображения, вызовы инструментов, потоковый вывод и расширенное мышление. Доступные блоки содержимого, инструменты и расширенные параметры могут различаться между моделями; ориентируйтесь на модели, доступные текущему ключу API, и фактические возможности API.

POST/v1/messages

Генерирует следующий ответ assistant на основе сообщений user и assistant. Содержимое сообщения может быть строкой или Content Blocks с текстом, изображениями, инструментами и документами.

API поддерживает обычные ответы JSON и потоковые события SSE; поддержка изображений, вызовов инструментов и расширенного мышления зависит от выбранной модели.

Аутентификация

anthropicApiKey

x-api-key<token>

Передавайте ключ API в Header x-api-key.

Расположение: header

Параметры Header

anthropic-version*string

Версия API, которую следует использовать.

По умолчанию"2023-06-01"

anthropic-beta?string

Версия beta, которую следует использовать. Можно разделить несколько значений запятыми или отправить этот Header несколько раз.

Тело запроса

Messages использует Content Blocks для текста, изображений, инструментов и расширенного мышления. Выберите представление по задаче.

application/json

Текстовый диалог

Используйте сообщения user и assistant для одного или нескольких ходов; system задаётся на верхнем уровне.

model: ID модели, доступной текущему ключу API и поддерживающей Messages.
max_tokens: Максимальное количество генерируемых токенов текущего ответа.
messages[]: Сообщения user и assistant по порядку.

application/json

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Здравствуйте! Представьтесь, пожалуйста."
    }
  ]
}

Простой текстовый диалог. messages может содержать строки или блоки text.

model*string

ID модели. Выберите модель, доступную текущему ключу API и поддерживающую Messages.

Длина1 <= length <= 256

max_tokens*integer

Максимальное количество генерируемых токенов. Лимиты зависят от модели; 0 позволяет только заполнить кэш промпта без генерации ответа.

Диапазон0 <= value

messages*array<>

Текстовые сообщения в порядке отправки. content может быть строкой или массивом блоков text.

Элементы1 <= items

metadata?

Метаданные, связанные с запросом.

cache_control?|null

Управление кэшем верхнего уровня, автоматически применяемое к последнему кэшируемому блоку содержимого запроса. Доступность зависит от модели и канала.

container?||null

Повторное использование контейнера между запросами или загрузка Skills в контейнер. Доступность зависит от модели, канала и аккаунта.

inference_geo?string|null

Географический регион выполнения вывода; если не задан, используется регион аккаунта по умолчанию. Доступность зависит от аккаунта и канала.

output_config?

Настройки вывода модели. Доступность полей зависит от выбранной модели и канала.

service_tier?string

Запрашиваемый уровень обслуживания. auto может использовать приоритетную ёмкость, если доступна; standard_only — только стандартную. Поддержка зависит от аккаунта и канала.

Допустимые значения

"auto"
"standard_only"

stop_sequences?array<string>

Пользовательские текстовые последовательности остановки генерации.

stream?boolean

Возвращать ли ответ постепенно через события, отправляемые сервером.

По умолчаниюfalse

system?|array<>

Системный промпт верхнего уровня. В списке Messages нет роли system.

temperature?number

Устарело

Устарело. Модели, выпущенные после Claude Opus 4.6, не поддерживают пользовательское temperature; для совместимости с прежними запросами может приниматься 1.0, другие значения могут вернуть 400. Для новых моделей рекомендуется опускать поле.

Диапазон0 <= value <= 1

thinking?||

Настройки расширенного мышления. Для новых моделей предпочтительно adaptive; старые могут продолжать использовать enabled и budget_tokens.

tool_choice?||

tools?array<|||||||>

Пользовательские или встроенные инструменты, доступные модели.

top_k?integer

Устарело

Устарело. Модели, выпущенные после Claude Opus 4.6, могут отклонить любое значение top_k с кодом 400. Для новых моделей рекомендуется опускать поле.

Диапазон1 <= value

top_p?number

Устарело

Устарело. Модели, выпущенные после Claude Opus 4.6, сохраняют ограниченную совместимость лишь с настройками, близкими к значению по умолчанию; другие значения могут вернуть 400. Для новых моделей рекомендуется опускать поле.

Диапазон0 < value < 1

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

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/messages" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "Здравствуйте! Представьтесь, пожалуйста."      }    ]  }'

{
  "content": [
    {
      "type": "text",
      "text": "Здравствуйте! Я — ИИ-помощник."
    }
  ],
  "id": "msg_example",
  "model": "MODEL_ID",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 16,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Официальная документация Anthropic MessagesОпределение протокола поставщика и последние изменения полей.

Аутентификация

Параметры Header

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`