Рассуждения

Управляйте рассуждениями моделей, читайте их рассуждения и токены рассуждений.

Модели с рассуждениями думают, прежде чем ответить. Это поддерживают модели с возможностью Рассуждения в каталоге.

Глубина рассуждений

{
  "model": "openai/gpt-oss-120b",
  "messages": [{ "role": "user", "content": "Is 1001 a prime number?" }],
  "reasoning": { "effort": "low" },
  "max_tokens": 4000
}

Поле `reasoning`	Значение
`effort`	`minimal`, `low`, `medium` или `high`: насколько много модель думает.
`max_tokens`	Бюджет токенов на рассуждения — для моделей, которые принимают его вместо `effort`.
`exclude`	`true`: модель все равно думает, но рассуждения не возвращаются.
`enabled`	`false` отключает рассуждения, если модель это позволяет.

reasoning_effort (поле OpenAI) работает как сокращение для effort.

В регионе Россия сохраняется только глубина: роутер передает reasoning.effort как reasoning_effort и удаляет остальную часть reasoning.

Как прочитать рассуждения

Если модель возвращает рассуждения, они приходят в message.reasoning (или reasoning_content, в зависимости от модели); в потоке — в delta.reasoning или delta.reasoning_content.

Токены и стоимость

Токены рассуждений — это выходные токены: они оплачиваются по цене вывода и входят в max_tokens. С лимитом по умолчанию 4096 модель может потратить его целиком на рассуждения и закончить с finish_reason: "length" и пустым ответом, поэтому задавайте max_tokens с запасом.

usage.completion_tokens_details.reasoning_tokens показывает, сколько выходных токенов ушло на рассуждения.