Схемы данных

management — ключ управления: модели не запускает, у него нет трат.

Режим без хранения аккаунта (no_store в GET /v1/settings): тексты запросов не сохраняются; файлы живут обычный срок.

Потолок трат ключа; null — без потолка.

Как обновляется потолок: none — потолок на всё время ключа, сам не обновляется; daily / monthly — spent считается с 00:00 UTC текущего дня / с 1-го числа текущего месяца. У ключа без потолка (spend_limit: null) — тоже none.

Потрачено в текущем окне потолка (при none — за всё время ключа), только завершённые списания.

Ключ заблокирован службой поддержки — отдельно от enabled: включить его снова нельзя, запросы по нему получают 403 key_blocked. Снять блокировку — через поддержку.

Автор ключа — только он открывает секрет (GET /v1/keys/{id}/secret); null — автор неизвестен или удалён из аккаунта, секрет не открыть.

RFC 3339; null — ключ бессрочный.

user — обычный ключ, management — ключ управления: модели не запускает, потолка трат нет.

Когда ключ последний раз прошёл проверку; null — ещё ни разу.

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

Можно ли показать секрет снова (GET /v1/keys/{id}/secret); false — показать нельзя (ответ 409 secret_unavailable), создайте новый ключ.

Подсказка секрета: приставка, первые 4 и последние 4 знака — узнать ключ, не открывая его; null — секрет не сохранён.

Потолок трат ключа в микроединицах валюты; null — без потолка.

Как часто обновляется потолок: none — на весь срок ключа; daily / monthly — spent_micro считается с 00:00 UTC текущего дня / с 1-го числа текущего месяца.

Списано по запросам ключа в текущем окне потолка (при none — за весь срок), в микроединицах; только завершённые запросы.

Аккаунт заблокирован службой поддержки: новые запросы его ключей и плейграунда получают 403 account_blocked; вход, баланс, история и уже принятые запросы остаются. Снять блокировку — через поддержку.

false — у аккаунта нет баланса, расход учитывается по факту; пополнение, оплата, бонусы и история баланса недоступны (403 account_without_balance).

Номер аккаунта в виде автомобильного номера: буква, три цифры, две буквы и код региона РФ из двух или трёх цифр — «К 482 МТ · 77», «Р 105 ОС · 761». Случайный и уникальный; по нему поддержка находит аккаунт. Буквы — только А В Е К М Н О Р С Т У Х, у которых одно начертание в кириллице и латинице, поэтому номер принимается в любой раскладке, с пробелами и без.

Потолок цены; null снимает потолок, без поля — не меняется.

Режим без хранения для всех ключей аккаунта; без поля — не меняется.

Потолок цены для всех ключей аккаунта, когда запрос его не задаёт; null — без потолка.

Режим без хранения для всех ключей аккаунта, включая плейграунд. По умолчанию выключен: тексты запросов — промпт, сообщения и ответ чата, текст речи, расшифровка — хранятся до retention.chat_content_days дней, файлы — retention.files_days. Включён — тексты запросов и ответов не сохраняются; файлы живут retention.files_days, как без режима. store: false в запросе включает то же для одного вызова.

Сроки хранения, те же, что в GET /v1/key.

Пресет роутинга для всех ключей аккаунта, включая встроенный ключ плейграунда, когда запрос его не называет.

Курсор следующей (более старой) страницы для before; null — страниц больше нет.

dep_N у пополнения, rfd_N у возврата, rev_N у отмены, id запроса у списания.

У списания — запрос, за который оно; у компенсации (label compensation) — запрос, за который она начислена. Поля ниже — только у списания.

Только у бонуса от службы поддержки: topup_bonus — бонус к пополнению, compensation — компенсация за запрос (job_id), bonus — бонус. Нет поля — приветственный бонус или бонус по приглашению.

У пополнения: payment — оплата, bonus — бонус (приветственный, по приглашению или от поддержки). У отмены — что отменено: оплата или бонус.

Есть ли на этом сервере тестовое пополнение баланса; в рабочем API всегда false.

Разрешённая сумма минуса в микроединицах валюты аккаунта.

Сумма, доступная для новых запросов с учётом овердрафта и текущих обязательств.

Сколько аккаунт потратил за всё время: сумма списаний за успешные запросы в микроединицах currency. Обновляется в течение минуты после завершения запроса.

Способ оплаты пополнения: card — банковская карта, sbp — Система быстрых платежей, other — другой способ платёжной страницы. Отсутствует у бонуса и пока платёжная система не сообщила способ (обычно в течение минуты после оплаты).

HTTPS-ссылка на чек покупки, если документ доступен. Отсутствует у бонуса и при отсутствии ссылки; не является подтверждением доставки письма.

Часть remaining_micro, удержанная для возврата; у бонуса всегда 0.

Уже возвращено из этого пополнения; у бонуса всегда 0.

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

Сколько из этого пополнения отменила служба поддержки (операции reversal); это не расход и не возврат.

Звук в messages[].content (input_audio).

Файл, например PDF, в messages[].content (file).

Параметры запроса, которые учитывает хотя бы один канал модели. Нет поля — список опубликован не у всех каналов.

Видео в messages[].content (video_url).

Картинка в messages[].content (image_url).

Вызовов канала за 7 дней.

Ровно 28 интервалов по возрастанию; последний — текущий, ещё не закрытый.

Доля успешных за 7 дней, от 0 до 1. null — меньше двадцати вызовов.

Начало интервала, UTC (00:00, 06:00, 12:00 или 18:00).

Медиана задержки успешных вызовов, мс (±10 %) — у чата до первого содержимого, у остальных до результата.

Доля успешных вызовов интервала, от 0 до 1. null — меньше пяти вызовов; это не ноль.

Только чат — медиана скорости выдачи, токенов в секунду.

Медиана времени успешного выполнения, мс; у чата — до первого содержимого ответа.

90-й процентиль времени успешного выполнения, мс; у чата — до первого содержимого ответа.

Число успешных замеров, использованных для latency_p50_ms и latency_p90_ms; 0, если оценки нет.

Окно замеров задержки в секундах — сутки или 7 дней; 0, если оценки нет.

Число успешных запросов и сбоев исполнения за сутки, по которым считается success_rate. Не число замеров задержки или скорости выдачи.

Доля успешных среди успешных запросов и сбоев исполнения за сутки, от нуля до единицы. Публикуется от двадцати таких запросов. Ошибки параметров, отказы по содержимому, отмены, ограничения канала, перегрузка и неотправленные запросы исключены.

Успешные запросы среди samples за сутки.

Чат — медиана скорости выдачи содержимого, токенов в секунду, после первого токена.

Чат — 90-й процентиль скорости выдачи содержимого, токенов в секунду. У остальных модальностей null.

Число успешных замеров выдачи, использованных для throughput_p50 и throughput_p90; 0, если оценки нет или это не чат.

Окно замеров скорости выдачи в секундах — сутки или 7 дней; 0, если оценки нет или это не чат.

Общее окно времени и скорости для существующих клиентов — 86400 или 604800; если хотя бы одна оценка взята за неделю, 604800. Для каждой метрики используйте её latency_window_seconds или throughput_window_seconds.

Остальные единицы — сумма сценария (в строке options — за её сочетание параметров).

per_1m_tokens — вход из кэша за 1M токенов, если у канала отдельная ставка.

true — динамическая цена канала: сумма — оценка сценария, итог — по фактическому расходу.

per_1m_tokens — вход за 1M токенов.

per_1m_tokens — выход за 1M токенов.

Фактический цвет канала, который дал этот ответ. Название и HEX — GET /v1/channels.

chatcmpl-…; тот же id открывает GET /v1/jobs/{id}.

Фактический цвет канала, который дал этот ответ. Название и HEX — GET /v1/channels.

Граница ответа (или max_completion_tokens). Без поля — предел модели. Если баланса хватает не на весь ответ, модели передаётся граница по оплачиваемому (не меньше 1000 токенов).

{"type": "json_schema", …} — у моделей с capabilities.structured_output.

false — запрос без хранения: тексты запроса и ответа не сохраняются; файлы живут обычный срок. По умолчанию тексты хранятся; true не отменяет режим без хранения аккаунта.

auto, none, required или конкретная функция. required и конкретную функцию исполняют не все каналы; если ни один — 400 capability_mismatch с путём tool_choice.

Инструменты OpenAI; модель без capabilities.tools — 400 capability_mismatch.

Текст или части — как у OpenAI: text, image_url, file, input_audio, video_url. Картинка, файл, звук и видео уходят только в каналы, которые их принимают (capabilities модели); если таких нет — 400 capability_mismatch.

Картинки мультимодальной модели — data-URI, не сохраняются.

Сколько списано за вызов, микроединицы currency — в итоговом ответе и последнем чанке потока.

user — обычный ключ, запускает модели; management — ключ управления: создают владелец и администратор и только в кабинете, трат и потолка у него нет.

Потолок трат ключа в микроединицах валюты; без поля — без потолка. У ключа управления потолка нет: с полем — 400.

Как часто обновляется потолок: none (по умолчанию, на весь срок), daily, monthly — по UTC.

Тот же день в разрезе моделей, по расходу вниз; сумма по моделям равна итогам дня.

Завершённые запросы дня (успех, провал, отмена); succeeded — из них успешные.

Что именно не так — когда это известно.

Только у maintenance — до какого времени приостановлены новые запросы.

Короткая фраза для человека и лога; ветвиться по ней не нужно.

Только у maintenance — причина плановых работ, для людей.

Только у картинок.

Только у картинок.

Файл; имя берётся из части формы.

Поле SDK OpenAI; принимается и ни на что не влияет.

Музыка — трек без вокала.

Музыка — свой текст песни из запроса; стирается вместе с промптом.

Хранился ли текст запроса. false — запрос без хранения (store: false или режим аккаунта), и после завершения промпт стёрт: пустой prompt тогда значит «не сохранён», а не «не отправлен».

Музыка — название трека из запроса; стирается вместе с промптом.

Тот же час в разрезе моделей, все модели часа, по расходу вниз; сумма по моделям равна итогам часа. Всегда массив.

Начало часа завершения запросов, UTC.

Завершённые запросы часа (успех, провал, отмена); succeeded — из них успешные.

Соотношение сторон или auto — умолчание модели.

Куда прислать вебхук — https на публичный хост; без поля — адрес по умолчанию из настроек аккаунта.

Поле OpenAI; принимается, модель отвечает со своей модерацией.

Поле OpenAI — сколько картинок; больше одной — у моделей, чья карточка это объявляет.

Поле OpenAI; принимается, сжатие файла — как у модели.

Формат файла; переводим сами, у любой модели.

Поле OpenAI; промежуточных кадров нет — в потоке приходит только итог.

Конкретный уровень качества по схеме модели. Без поля используется medium; auto — только при явном выборе. Явный уровень ограничивает каналы, которые гарантируют его выполнение. Допустимые значения канала — parameters.quality в GET /v1/models/{id}/channels.

Референсы — картинки.

Поле OpenAI; b64_json — картинка ещё и base64 в data[].b64_json.

Поле OpenAI: размер ШxВ или auto. Переводится в aspect_ratio и resolution модели; вместе с ними не присылается (mutually_exclusive).

false — запрос без хранения: тексты запроса и ответа не сохраняются; файлы живут обычный срок. По умолчанию тексты хранятся; true не отменяет режим без хранения аккаунта.

Поле OpenAI; true — ответ text/event-stream: событие image_generation.completed с картинкой base64 на каждую картинку, затем поток закрывается. Ошибка и задача, не успевшая за 9 минут, — обычным JSON со статусом.

Поле OpenAI; принимается, стиль задаёт промпт.

Поле OpenAI (id конечного пользователя); принимается, ни на что не влияет и не хранится.

Модель может сверяться с интернетом.

Выполненное действие с аудио.

Фактический цвет канала запроса: при успехе — канал, который выполнил запрос; пока запрос идёт — канал, которому он уже отправлен; при ошибке — последний вызванный канал. null — запрос ещё не отправлялся ни одному каналу или запись старше каналов. Название и HEX цвета — GET /v1/channels.

Когда задача завершилась; null, пока идёт.

То же время, что created_at, в unix-секундах — как created у OpenAI.

Файлы результата; data[0] — сам результат. У музыкальной модели, которая за запрос даёт два варианта трека, оба — role: result, по порядку. Пустой, пока задача не завершена, и у чата.

Транскрибация — длительность звука в секундах.

Почему задача не удалась; null, если не провалилась.

job_…; у чата — chatcmpl-… из его ответа.

Транскрибация — язык записи, код ISO 639-1 (ru, en) у любой модели: названный моделью или, если она его не назвала, из подсказки language запроса. Язык неизвестен — поля нет.

Потолок цены, с которым задача принята: из запроса или из настроек аккаунта на момент приёма. null — без потолка.

Версия музыкальной модели; используйте её при продолжении исходного трека.

ID этой задачи для повторного использования созданной персоны.

Итог в микроединицах currency — фактический объём × цены сработавшего канала на момент приёма; null, пока задача не завершена. У проваленной — 0.

Настройки каналов, с которыми задача принята: из запроса или из настроек аккаунта на момент приёма. null — каналы выбирает Авто-роутинг.

Транскрибация, verbose_json у модели с таймкодами — фразы: предложение или отрезок речи до паузы в секунду и дольше, не длиннее 30 с. Начало фразы — начало её первого слова, конец — конец последнего; одинаково у всех моделей.

Транскрибация — расшифровка; у остальных задач поля нет.

Объём выполненного — токены, символы, секунды; null, где мерить нечего.

ID этой задачи для повторного использования созданного голоса.

Транскрибация — слова с таймкодами, если запрошена детализация по словам.

Что ушло в модель: сообщения и параметры, модель — по id каталога.

Ответ модели — content, finish_reason, tool_calls; поля нет, если ответа не было.

Сохранённая копия неполная: длинные строки обрезаны до 256 КиБ на поле или поток оборвался раньше конца ответа.

Действие музыкального запроса. У старых запросов на создание песни — generate; у других типов запросов поля нет.

Фактический цвет канала запроса: при успехе — канал, который выполнил запрос; пока запрос идёт — канал, которому он уже отправлен; при ошибке — последний вызванный канал. null — запрос ещё не отправлялся ни одному каналу или запись старше каналов. Название и HEX цвета — GET /v1/channels.

Содержимое чата, пока оно хранится.

Сколько шёл запрос целиком, от приёма до итога, — та же цифра, что в списке; есть у завершённого запроса.

Есть у не удавшегося запроса.

Другие файлы той же генерации, по порядку, тем же описанием, что result: второй музыкальный вариант, дополнительные дорожки или изображения.

Запись, отправленная на расшифровку; после срока хранения — описание без ссылки.

Текст запроса на озвучку; хранится тот же срок, что содержимое чата. Голос и сведения о результате остаются в карточке.

Выбранная версия музыкальной модели, если она была указана в запросе.

Параметры генерации — у изображений, видео, музыки и расшифровки.

Результат успешной генерации — то же описание файла, что в GET /v1/jobs/{id}: подписанная ссылка, пока файл хранится, после — expired: true. last_frame — второй файл, если видео его вернуло.

Откуда пресет routing, в котором шёл запрос, — из запроса (request) или из настройки аккаунта (account).

Расшифровка успешного запроса на транскрибацию; хранится тот же срок, что содержимое чата, потом поля нет.

Объём расшифровки; остаётся и после того, как текст перестал храниться.

Действие музыкального запроса. У старых запросов на создание песни — generate; у других типов запросов поля нет.

Вид ключа запроса: user — обычный ключ, playground — встроенный ключ плейграунда (в списке ключей его нет), agent — ключ агента.

Фактический цвет канала запроса: при успехе — канал, который выполнил запрос; пока запрос идёт — канал, которому он уже отправлен; при ошибке — последний вызванный канал. null — запрос ещё не отправлялся ни одному каналу или запись старше каналов. Название и HEX цвета — GET /v1/channels.

Сколько символов (Unicode) дала расшифровка — то же число, что usage.characters в её ответе; только у транскрибации.

На каком параметре не удался запрос и что было бы принято — в той же форме, что error.detail. Обычно поля нет; у удавшегося запроса его нет никогда.

Сколько шёл запрос целиком, от приёма до итога; есть у завершённого запроса.

Почему запрос не удался — код закрытого словаря; есть только в статусе failed. Неизвестная ошибка — unknown_error, без подробностей.

Токены чата — входные (input_tokens) и выходные (output_tokens); у картинок и видео их нет.

Выбранная версия музыкальной модели, если она была указана в запросе.

Итоговая цена завершённого запроса в микроединицах (у не удавшегося — 0); null — запрос ещё идёт.

Файл результата удавшейся генерации — то же описание, что result в GET /v1/usage/{id}: подписанная ссылка, пока файл жив, expired: true после. У чата и незавершённых запросов поля нет.

Откуда пресет routing, в котором шёл запрос, — из запроса (request) или из настройки аккаунта (account).

На каком параметре не удался запрос и что было бы принято — в той же форме, что error.detail в GET /v1/jobs/{id}.

У речи с посимвольной оплатой — символов по счёту этой модели; у посекундной речи поля нет.

Речь — символов на входе; транскрибация — в расшифровке.

Чат.

Чат.

Речь — длительность звука.

Чат.

Символы (Unicode) расшифровки — то же число, что вернул POST /v1/audio/transcriptions.

Почему последняя попытка доставки не засчитана.

Последний HTTP-статус получателя.

Наибольшая длительность готового звука в секундах, если известна.

Номер запроса; ответ вернёт его же. Без id — уведомление.

Параметры метода; у tools/call — name инструмента и arguments по его inputSchema.

Ошибка протокола JSON-RPC.

id запроса; null — запрос не удалось разобрать.

Итог метода. У tools/call — content (текст с таблицей), structuredContent (те же данные объектом) и isError.

Картинка участника — адрес в кабинете (?v= меняется вместе с картинкой) — или null.

Почта участника; пустая строка — участник приглашён только по username Telegram. telegram_username — username Telegram (строчными, без @) или пустая строка; хотя бы одно из двух есть.

Имя; пустая строка, пока участник не вошёл через провайдера входа и не задал имя в профиле.

Роль участника в аккаунте: owner, admin, developer или viewer.

Собственный лимит трат участника — с расходом и остатком в текущем окне; null — лимита нет (владелец, администратор, наблюдатель, разработчик без лимита).

Unix-время появления модели в каталоге (added_at) — поле models.list SDK OpenAI.

То, что идёт в поле model запроса.

JSON Schema 2020-12 тела запроса к этой модели, включая условные пределы текста музыки: какие поля и значения она принимает. Годится как parameters инструмента и inputSchema MCP. Значения, которые у модели ничего не меняют, в ней тоже есть — они принимаются.

Автор модели — vendor.id (пусто, если автор не указан); поле models.list SDK OpenAI.

Те же поля для витрины — с подписями и подсказками.

Какие сочетания значений допустимы — то, что не выражает params.

Автор модели; null, если не указан.

Пределы конкретного канала в токенах; null означает, что предел неизвестен.

Параметры, выполнение которых гарантирует канал; отсутствие поля означает отсутствие подтверждённой поддержки.

true — динамическая цена: request — оценка для параметров по умолчанию, итог считается по фактическому расходу у канала и может отличаться от оценки.

Сумма в микроединицах currency за единицу basis. Для default_request — оценка запроса с указанными параметрами; у динамической цены она может уточняться по сопоставимым выполненным запросам. Токеновые ставки остаются в tokens.

Цены, по которым считается итог канала с динамической ценой (dynamic), в микроединицах currency за 1M токенов. null у канала с ценой, известной заранее.

Когда собран каталог (до часа).

Медиана времени ответа успешных запросов, мс (±10 %); null — успешных нет.

95 % успешных запросов отвечают быстрее, мс (±10 %); null — успешных нет.

Ровно 168 часов по возрастанию.

Скорость опций пресетов роутинга за 7 дней: по ряду на опцию — те же опции и в том же порядке, что pricing.presets карточки модели (параметры по умолчанию). От одного до трёх рядов; пусто, когда цены нет. Точка ряда — медиана успешных запросов первого канала опции за 6 часов, с любым пресетом. Ряды разных опций могут численно совпадать.

Доля успешных среди завершённых запросов, от 0 до 1; отказы по вине запроса (ошибка во входных данных, правила модели, нехватка баланса, несовместимые параметры) не считаются. null — считать не из чего.

Когда числа пересчитаны.

Начало часа, UTC.

Не выполнены; отказы по вине запроса не считаются, как и в success_rate.

Самый долгий успешный запрос часа, мс; null — успешных нет.

Самый быстрый успешный запрос часа, мс; null — успешных нет.

5 % успешных запросов часа отвечают быстрее, мс (±10 %); null — успешных нет. Вместе с latency_p95_ms — полоса обычного времени ответа без редких крайних значений.

Медиана времени ответа успешных запросов часа, мс (±10 %); null — успешных нет.

95 % успешных запросов часа отвечают быстрее, мс (±10 %); null — успешных нет.

Ровно 28 интервалов по 6 часов по возрастанию; последний — текущий, ещё не закрытый.

Пресеты опции — как routing опции в pricing.presets.

Единица value: seconds — время выполнения запроса, секунды; tokens_per_second — у чата: скорость ответа, выходных токенов в секунду за всё время ответа (время ответа чата зависит от его длины).

Начало интервала, UTC (00:00, 06:00, 12:00 или 18:00).

Медиана успешных запросов за интервал в единице unit, приближённая (ошибка до 20 %); null — успешных запросов не было.

Из них не выполнены; отказы по вине запроса не считаются, как и в success_rate. Сумма failed по часам GET /v1/models/{id}/stats.

Медиана времени ответа успешных запросов, мс (±10 %).

95 % успешных запросов отвечают быстрее, мс (±10 %).

Запросы за окно в любом статусе.

Из них завершились успешно.

Доля успешных среди завершённых запросов, succeeded / (succeeded + failed), от 0 до 1; отказы по вине запроса (ошибка во входных данных, правила модели, нехватка баланса, несовместимые параметры) не считаются.

Сколько токенов выдала модель — только у чата.

Когда числа пересчитаны.

Действие с музыкой или звуком; без поля — создание музыки.

Влияние аудиоэлементов; доступно и при создании в custom_mode.

Автор.

Куда прислать вебхук — https на публичный хост; без поля — адрес по умолчанию из настроек аккаунта.

С какой секунды продолжить исходный трек.

Создание по своему стилю и тексту; для инструментала текст не нужен.

Описание.

Подпись сайта.

Желаемая длительность в режиме своего текста или стиля.

Конец фрагмента.

Полный текст после замены.

Сохранить текст звука.

Трек без вокала.

Язык проверки голоса.

Текст песни — модель споёт его как написан; разделы размечаются [Verse], [Chorus], [Bridge]. Без поля текст пишет модель. Вместе с instrumental не присылается.

Имя.

Какие стили и элементы исключить.

ID задачи Союза, создавшей персону или голос.

Тип сохранённой персоны.

Описание трека: жанр, настроение, инструменты, темп, голос. Язык текста песни, который напишет модель, — язык описания. В custom_mode и при lyrics это музыкальный стиль.

Входные аудиофайлы — ссылки https или идентификаторы загруженных файлов.

Уровень вокала.

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

Зацикленный звук.

Темп звука в ударах в минуту.

ID аудиофайла из data исходной задачи.

ID готовой задачи Союза, принадлежащей вашему аккаунту.

Начало фрагмента.

Дорожка или инструмент.

false — запрос без хранения: тексты запроса и ответа не сохраняются; файлы живут обычный срок. По умолчанию тексты хранятся; true не отменяет режим без хранения аккаунта.

Точность следования стилю.

Название в режиме своего текста или стиля и при переработке аудио. Без него — первая строка текста песни или описания. В простом режиме название выбирает модель.

Поле OpenAI (id конечного пользователя); принимается, ни на что не влияет и не хранится.

Версия модели из её схемы параметров.

Предпочтительный вокал; результат не гарантирован.

Степень экспериментальности.

Слова и их таймкоды в секундах; success показывает, удалось ли выровнять слово.

Оценка ошибки выравнивания текста.

Готов ли проверяемый голос к использованию.

Нотные партии; pitch — MIDI-номер ноты, start/end — секунды, velocity — сила от 0 до 1.

Улучшенное описание музыкального стиля.

Состояние проверки голоса.

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

Амплитуды для визуализации звука, сохранённые вместе с результатом.

Поле API и документации; плейграунд не показывает и не отправляет его.

Значение по умолчанию — строка, число или логическое.

Перечисление внутри списка — сколько разных значений поле принимает во всём списке (голоса диалога речи).

Строка или число — то, что уходит в запрос.

Остальные единицы — за генерацию, секунду звука или 1M символов. В строке options — в той же единице, что amount_micro строки (у видео — цена сценария строки, за её billed_seconds секунд; ставка за секунду — деление на billed_seconds).

per_1m_tokens — вход из кэша за 1M токенов, если у этой опции есть отдельная ставка.

true — динамическая цена первого канала опции: сумма — оценка, итог — по фактическому расходу.

per_1m_tokens — вход за 1M токенов.

per_1m_tokens — выход за 1M токенов.

Пресеты, которые покрывает опция, по порядку cheap, balanced, fast.

Типичное время выполнения первого канала опции, секунды: медиана последних успешных запросов за сутки, если их меньше трёх — типичное за 7 дней (та же оценка, что в metrics каналов), округлённая: до 10 с — до секунды, 10–60 с — до 5 с, дольше — до 10 с; null — замеров нет. У чата всегда null: время ответа зависит от его длины.

Посекундное видео — сколько секунд тарифицируется в этом сочетании.

Цена каждого канала для этого сочетания параметров — как pricing.channels.

Верх полной цены того же сочетания параметров по всем пригодным каналам, включая запасные; у видео это цена ролика указанной длительности, а не ставка за секунду. null, если единицы расчёта различаются, длительность видео-входа неизвестна или у части каналов динамическая цена.

Опции пресетов роутинга для этого сочетания параметров — как pricing.presets.

Для изображений — минимальная цена каналов за генерацию с параметрами по умолчанию, как в каталоге каналов; другие сочетания представлены в options. Остальные единицы — за генерацию, секунду звука или 1M символов.

false — цены сейчас нет, сумм тоже нет.

per_1m_tokens — вход из кэша за 1M токенов, если есть отдельная ставка.

Цена каждого канала для параметров по умолчанию — в порядке палитры модели, как GET /v1/models/{id}/channels. Суммы — в единице unit: у чата ставки за 1M токенов, у остальных — сумма сценария. Канал, которому параметры не подходят, отсутствует. Пусто, когда цены нет.

true — у части каналов динамическая цена: их суммы — оценка, итог считается по фактическому расходу у канала и может отличаться от оценки. Верх max_amount_micro тогда null.

per_1m_tokens — вход за 1M токенов.

Верх ставки по всем пригодным каналам и доказуемо полному набору допустимых параметров в единице unit. Для видео null, поскольку полную цену генерации нельзя выдавать за секундную ставку; используйте верх конкретной строки options[].max_amount_micro. Также null, если единицы каналов различаются, полный охват не доказан или у части каналов динамическая цена (dynamic).

Верх ставки чтения кэша за 1M токенов; канал без отдельной ставки тарифицирует такой вход по обычной ставке.

Верх ставки входа за 1M токенов с учётом запасных каналов и ступени длинного контекста.

Верх ставки выхода за 1M токенов с учётом запасных каналов и ступени длинного контекста.

Стартовые цены отдельных сочетаний параметров.

per_1m_tokens — выход за 1M токенов.

Цены и типичное время пресетов роутинга для параметров по умолчанию — от одной до трёх опций. Одна опция может покрывать несколько пресетов: «Баланс» может входить в опцию «Дешевле» или «Быстрее». У разных опций цена и типичное время могут совпадать, хотя их поведение в Авто-роутинге различается. Переданный в запросе routing сохраняет выбранный порядок исполнения. Пусто, когда цены нет.

Музыка — действие (generate, cover, …), от него зависит цена.

Музыка — версия модели, от неё зависит цена.

Мягкое предпочтение по p50 задержки. Неизмеренные и более медленные каналы остаются запасными.

Мягкое предпочтение по p50 токенов в секунду; только чат (в запросе к другой модальности — 400).

Идентификатор диалога чата в пределах аккаунта и модели. Сохраняется только хеш.

Явная сортировка заменяет пресет; порядок цветов имеет приоритет. latency — время первого содержимого чата или всего результата; throughput — токены в секунду, только чат (в запросе к другой модальности — 400).

Закреплять успешное исполнение диалога на десять минут бездействия. Явный order имеет приоритет.

Каналы плана в порядке попыток: первый — тот, с которого начнётся запрос, следующие — запасные. Пустой список — запрос с этими условиями сейчас выполнить нельзя; почему — в excluded.

Оценка суммы первого канала цепочки для этих параметров. Может уточняться по сопоставимым выполненным запросам; итог зависит от фактического объёма и ставок на момент приёма. Запасной канал может стоить дороже. null — план пуст. План ознакомительный: при создании запроса он рассчитывается заново.

Каналы модели, которые в план не вошли, и почему. Каждый цвет — один раз.

Оценка суммы этого канала для параметров превью, в микроединицах currency; итог определяется фактическим объёмом и ставками на момент приёма запроса.

not_selected — цвет не прошёл only/ignore; above_max_price — дороже max_price или потолка max_price_multiplier; unsupported — канал не берёт эти параметры, возможности (инструменты, картинка, JSON-схема, поток) или пределы токенов; unavailable — канал сейчас не исполняет (пауза после сбоев, выключен); fallback_disabled — запасные каналы запрещены (allow_fallbacks: false).

Чат — в messages будет звук.

Чат — в messages будет файл (PDF).

Чат — сколько вариантов ответа; пределы выхода каналов и оценка считаются на все.

Речь — запрос с dialogue вместо input.

Речь — запрос с полем instructions.

Чат — в messages будет видео.

До какого времени приостановлены новые запросы.

Причина плановых работ, для людей.

Когда начались плановые работы.

ok — работает; maintenance — плановые работы, новые запросы до ends_at получают 503 maintenance; unavailable — сервис не отвечает вне плановых работ.

Реплики по порядку вместо input — диалог разными голосами. Только у моделей, в карточке которых есть это поле; число разных голосов, реплик и общий предел текста — там же.

Текст или описание звуковой сцены; предел длины — у модели, если указан. Обязателен, если нет dialogue; вместе с dialogue не присылается.

Как говорить — тон, темп и эмоция словами. Только у моделей, в карточке которых есть это поле; предел длины — там же.

Формат звука; без поля — родной формат модели.

Поле OpenAI; принимается, темп речи — как у модели.

false — запрос без хранения: тексты запроса и ответа не сохраняются; файлы живут обычный срок. По умолчанию тексты хранятся; true не отменяет режим без хранения аккаунта.

Поле OpenAI; sse — звук событиями text/event-stream: speech.audio.delta с base64 звука, затем speech.audio.done.

Поле OpenAI (id конечного пользователя); принимается, ни на что не влияет и не хранится.

Голос из карточки модели, если она предлагает выбор; без поля — умолчание модели.

Звук base64 — у speech.audio.delta.

Поле OpenAI (auto или объект server_vad); принимается, запись делит модель. В multipart также принимаются поля chunking_strategy[…].

wav, mp3, flac, m4a, ogg, webm, aac, до 25 МиБ; формат определяется по байтам.

Поле OpenAI; принимается, вероятностей токенов в ответе нет. В multipart также принимается запись include[].

Язык записи, код ISO 639-1 (ru, en); без поля язык определяет модель. Другое написание (RU, ru-RU, russian) — 400 со списком кодов в allowed.

Поле OpenAI; принимается, модель расшифровывает без подсказки.

false — запрос без хранения: тексты запроса и ответа не сохраняются; файлы живут обычный срок. По умолчанию тексты хранятся; true не отменяет режим без хранения аккаунта.

Поле OpenAI; true — ответ text/event-stream: transcript.text.delta с текстом, затем transcript.text.done.

Поле OpenAI; принимается, ни на что не влияет.

Таймкоды фраз и слов; только вместе с verbose_json у моделей, которые их поддерживают. В multipart также принимается запись timestamp_granularities[].

Поле OpenAI (id конечного пользователя); принимается, ни на что не влияет и не хранится.

Начало, секунды от начала записи.

Текст — у transcript.text.delta.

Вся расшифровка — у transcript.text.done.

Начало, секунды от начала записи.

RFC 3339; null — ключ бессрочный.

null — без потолка.

none | daily | monthly; без поля — none.

Курсор следующей (более старой) страницы для before; null — страниц больше нет.

Ряд по UTC-дням; дней без запросов в нём нет. С bucket=hour — пустой, ряд в hourly.

Ряд по UTC-часам — только с bucket=hour; часов без запросов в нём нет, по часу вверх.

Сгенерировать звуковую дорожку.