Сообщения

Messages API — основной способ взаимодействия с моделями Claude через Claudexia. Отправьте структурированный список сообщений и получите ответ модели.

Эндпоинт

http

POST https://api.claudexia.tech/v1/messages

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

Укажите API-ключ в заголовке x-api-key:

http

x-api-key: sk_cdx_YOUR_KEY

Тело запроса

Параметр	Тип	Обязательный	Описание
`model`	string	Да	ID модели (например, claude-sonnet-4-20250514).
`max_tokens`	integer	Да	Максимальное количество генерируемых токенов.
`messages`	array	Да	Массив объектов сообщений с role ("user" или "assistant") и content (строка или массив блоков контента).
`system`	string	Нет	Системный промпт для управления поведением модели.
`temperature`	number	Нет	Температура сэмплирования от 0 до 1. По умолчанию: 1.
`top_p`	number	Нет	Параметр nucleus sampling. По умолчанию: 0.999.
`stream`	boolean	Нет	Если true, возвращает поток Server-Sent Events. По умолчанию: false.
`thinking`	object	Нет	Включить расширенное размышление. См. раздел Размышление ниже.

Ответ

Поле	Тип	Описание
`id`	string	Уникальный ID сообщения (например, msg_01XFDUDYJgAACzvnptvVoYEL).
`type`	string	Всегда "message".
`role`	string	Всегда "assistant".
`content`	array	Массив блоков контента. Каждый блок имеет type ("text") и text.
`model`	string	Модель, сгенерировавшая ответ.
`stop_reason`	string	Причина остановки: "end_turn", "max_tokens" или "stop_sequence".
`usage`	object	Использование токенов: input_tokens и output_tokens.

Пример

Запрос

bash

curl https://api.claudexia.tech/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_cdx_YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4.5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

Ответ

json

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-4.5",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 10
  }
}

Стриминг

Установите stream: true в теле запроса для получения ответа в виде потока Server-Sent Events (SSE). Подробности о формате событий см. на странице Стриминг.

bash

curl --no-buffer https://api.claudexia.tech/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_cdx_<YOUR_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "accept: text/event-stream" \
  -d '{
    "model": "claude-opus-4.7",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Vision (блоки изображений)

Для моделей с vision отправляйте мультимодальный контент: текст и блоки image (ниже пример с URL).

json

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in this image?"},
        {
          "type": "image",
          "source": {"type": "url", "url": "https://example.com/picture.jpg"}
        }
      ]
    }
  ]
}

Размышление (Extended Thinking)

Включите расширенное размышление, чтобы модель обдумала сложные задачи перед ответом. Передайте объект thinking в теле запроса:

json

{
  "model": "claude-sonnet-4.5",
  "max_tokens": 16000,
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  },
  "messages": [
    {"role": "user", "content": "What is the derivative of x^3 * sin(x)?"}
  ]
}

При включённом размышлении массив content ответа может содержать блок с type: "thinking" с рассуждениями модели, за которым следует финальный ответ type: "text". Параметр budget_tokens контролирует максимум токенов для процесса размышления.

Обзор

Модели