Структура ответа

Каждый успешный вызов эндпоинта POST /api/v1/chat возвращает JSON-объект с детальной информацией о результате генерации, использованных ресурсах и стоимости.

Ниже представлен пример полного ответа со всеми возможными полями.

{
  "response": {
    "text": "Это текст ответа от модели...",
    "reasoning": "Это размышления модели перед ответом (если поддерживается)..."
  },
  "usage": {
    "prompt_tokens": 150,
    "completion_tokens": 75,
    "total_tokens": 225,
    "cache_read_tokens": 50,
    "cache_write_tokens": 100
  },
  "cost": {
    "input_cost_rub": 0.0450,
    "output_cost_rub": 0.0900,
    "image_cost_rub": 0.1500,
    "cache_cost_rub": 0.0100,
    "total_cost_rub": 0.2950,
    "currency": "RUB"
  },
  "model": {
    "model": "claude-3.5-sonnet",
    "context_window": 200000,
    "supports_images": true
  },
  "has_reasoning": true
}

Объект response

Содержит результаты генерации.

КлючТипОписание
text string Основной сгенерированный моделью текст. Это и есть ответ на ваш запрос.
reasoning string | null Размышления модели перед генерацией ответа ("цепочка мыслей"). Возвращается только некоторыми моделями (например, Claude 3.5 Sonnet) и может быть null.

Объект usage

Содержит информацию об использованных токенах.

КлючТипОписание
prompt_tokens integer Количество токенов в вашем запросе (включая prompt, messages и system_prompt).
completion_tokens integer Количество токенов в сгенерированном моделью ответе.
total_tokens integer Сумма prompt_tokens и completion_tokens.
cache_read_tokens integer | null Количество токенов, прочитанных из кеша (для моделей Claude). Снижает стоимость. Может быть null.
cache_write_tokens integer | null Количество токенов, записанных в кеш для будущих запросов (для моделей Claude). Может быть null.

Объект cost

Содержит детализированную стоимость запроса в рублях (RUB).

КлючТипОписание
input_cost_rub float Стоимость токенов на входе (prompt).
output_cost_rub float Стоимость сгенерированных токенов (completion).
image_cost_rub float | null Стоимость обработки изображений, если они были переданы.
cache_cost_rub float | null Стоимость операций с кешем (для моделей Claude).
total_cost_rub float Итоговая стоимость всего запроса, которая будет списана с вашего баланса.
currency string Валюта, в которой произведен расчет (всегда "RUB").

Объект model

Содержит информацию о модели, которая обработала запрос.

КлючТипОписание
model string Ключ модели, который вы указали в запросе.
context_window integer Максимальный размер контекстного окна модели в токенах.
supports_images boolean true, если модель поддерживает обработку изображений.

Поле has_reasoning

Удобный флаг для быстрой проверки наличия размышлений.

КлючТипОписание
has_reasoning boolean true, если поле response.reasoning не пустое, иначе false.