Перейти к основному содержанию
POST
Ответ модели

Авторизации

Authorization
string
header
обязательно

Передача токена авторизации в заголовке Authorization: Bearer .

Заголовки

X-Session-ID
string

Идентификатор сессии диалога (альтернатива полю session_id в теле запроса).

Тело

application/json

Стандартные поля OpenAI temperature, top_p, max_tokens, max_completion_tokens, stop, n и response_format принимаются, но не применяются.

messages
object[]
обязательно

Список предшествующих сообщений беседы.

Minimum array length: 1
model
enum<string>
по умолчанию:niya-1

Идентификатор модели:

  • niya-1 — Ния (основная модель для общих задач и модерации, 1M контекст)
  • emmy-1 — Эмми (интеллектуальная модель с пошаговым рассуждением, 1M контекст)
  • hubert-1 — Хуберт (кастомная модель, 1M контекст)
Доступные опции:
niya-1,
emmy-1,
hubert-1,
default
Пример:

"niya-1"

files
object[]

Дополнительный список файлов или изображений, прикреплённых к запросу.

stream
boolean
по умолчанию:false

Включение потоковой передачи ответов Server-Sent Events (SSE).

stream_options
object
thinking
boolean

Включение режима пошагового размышления (цепочки рассуждений).

Пример:

true

surzhyk
boolean
по умолчанию:false

Для модели hubert-1 включает фирменный суржик. По умолчанию Хуберт отвечает на языке последнего сообщения пользователя.

effort
enum<string>

Степень детализации рассуждений (уровень размышлений):

  • low — базовая проверка фактов;
  • medium — сбалансированный анализ (по умолчанию);
  • high — исчерпывающий пошаговый разбор;
  • extra / max — предельный уровень аналитики.
Доступные опции:
low,
medium,
high,
extra,
max
Пример:

"medium"

session_id
string

Публичный идентификатор сессии чата (UUIDv4). Позволяет сохранять контекст между запросами.

Пример:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

regenerate
boolean

Флаг принудительной повторной генерации последнего ответа.

tools
object[]

Инструменты в формате OpenAI. Работают только с агентским ключом (sk-agent-…); для чат-ключа игнорируются.

tool_choice

Выбор инструмента в формате OpenAI.

reasoning_effort
string

Уровень рассуждений в формате OpenAI. То же, что effort.

Разрешить модели поиск в интернете.

Ответ

Успешный ответ модели или поток чанков (SSE).

id
string
Пример:

"chatcmpl-9b2f6c1e4a7d4c0e9f1a2b3c"

session_id
string
Пример:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

object
string
Пример:

"chat.completion"

created
integer
Пример:

1726838400

model
string
Пример:

"niya-1"

choices
object[]
usage
object

Расход токенов. prompt_tokens включает кэшированные токены, total_tokens = prompt_tokens + completion_tokens. cost_credits — списанные AI-кредиты.