POST/orders/{order}/retry

UUID шаблона. Его кладут в template_id при создании заказа.

ID владельца шаблона.

Короткий публичный идентификатор для расшаривания. null у шаблона, которым не делились.

Название шаблона — только для человека, на поведение генерации не влияет.

Код сервиса, по схеме которого валидируется config: elevenlabs, lumimg и т. д.

Сервис шаблона справочно: название и тарификация, без схем конфигурации. null означает, что сервиса с таким кодом больше нет.

Настройки генерации: голос, модель, скорость и прочее — набор ключей задаёт сервис. Допустимые значения смотрите в GET /templates/config-options?service=<код>, значение вне схемы отклоняется с 422. В заказе (template в GET /orders/{order}) это настройки самого заказа — снимок на момент его создания с config_override, а не текущий конфиг шаблона (у заказов, созданных до конца сентября 2026 года, — текущий конфиг шаблона с config_override).

Опубликован ли шаблон в общем каталоге.

UUID папки, в которой лежит шаблон, либо null для корня. Структура папок видна в GET /templates/browse.

Когда шаблон создан, ISO 8601.

Когда шаблон последний раз менялся, ISO 8601.

Внутренний идентификатор актива.

Код актива: LUMC — внутренняя валюта, TOKEN — токены генерации.

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

Число десятичных знаков. Ключевое поле: любая целая сумма этого актива делится на 10^precision, чтобы получить реальное значение. Не считайте, что делитель равен 100.

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

Когда актив выведен из обращения, ISO 8601. null у действующего.

Когда актив заведён, ISO 8601.

Когда актив последний раз менялся, ISO 8601.

Номер абзаца, с нуля.

Сколько чанков попало в этот абзац.

Сколько чанков абзаца уже готово.

Сводный статус абзаца: он выводится из статусов его чанков, а не хранится отдельно. Словарь свой, короче общего: pending, in_progress, failed, completed — заблокированный модерацией чанк тоже даёт failed. Считаются только исходные чанки, поэтому успешный повтор упавшего фрагмента статус абзаца НЕ меняет: смотрите на сам фрагмент в items[].

Готовность абзаца в процентах, 0–100.

Склеенное аудио абзаца целиком: абсолютный путь либо структура с путём и размером. Скачивается через POST /storage/url, как и остальные файлы заказа. null читается по-разному в зависимости от chunks_count: при chunks_count = 1 собственного файла у абзаца нет и не будет — абзац это и есть тот единственный фрагмент, берите его result_file из items[] по тому же paragraph_index; при chunks_count > 1 склейки ещё не было — многочанковый абзац получает файл ТОЛЬКО после неё, никогда заранее.

UUID чанка. Подставляется в пути /orders/{order}/items/{item}/….

UUID заказа, которому принадлежит чанк.

Природа записи: chunk — исходный фрагмент, retry — бесплатный повтор упавшего фрагмента, regeneration — платная переделка готового.

Повторы и перегенерации живут отдельными записями с тем же chunk_index: история попыток сохраняется целиком, а звучит в результате последняя.

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

Номер абзаца, к которому относится фрагмент, — заполняется только у исходных фрагментов абзацного заказа. null и в обычном режиме, и у записей повтора либо перегенерации: у них своей привязки к абзацу нет, её берут у родительского фрагмента через parent_item_id. Режим включается ключом generation_mode в config_override заказа.

UUID исходного чанка — у записей retry и regeneration. У самого исходного чанка null.

Длина текста, с которой фрагмент создавался. Служит потолком для text в regenerate.

Длина актуального текста фрагмента: после перегенерации отличается от original_text_length.

Стоимость фрагмента в токенах — это не деньги. Денежная сумма лежит у самого заказа, в его поле price_units (там LMC, здесь токены; поля называются одинаково, единицы разные).

Сколько токенов фактически списано по этому фрагменту. У незавершённого фрагмента — 0.

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

Состояние фрагмента: pending — ждёт воркера, processing — в работе, completed — готов, failed — техническая ошибка, policy_flagged — отклонён контентной политикой.

Разница между двумя последними определяет способ лечения: failed чинится повтором как есть, policy_flagged — только переформулировкой текста, повтор с прежним будет отклонён снова.

Файл готового фрагмента: абсолютный путь либо структура с путём и размером. Скачивается через POST /storage/url, как и файлы заказа. null, пока фрагмент не готов.

Длительность полученного аудио в миллисекундах — длина записи, а не время генерации. У не-аудио задач null.

Номер попытки для этого фрагмента, начиная с 1. Растёт с каждым повтором.

Разрешён ли бесплатный повтор прямо сейчас. Учитывает статус, тип задачи и исчерпание попыток — проверять условия самому не нужно.

Разрешена ли платная перегенерация прямо сейчас. Доступна только для завершённых фрагментов.

Когда фрагмент создан, ISO 8601.

Когда фрагмент последний раз менялся, ISO 8601.

Причина падения в машиночитаемом виде — есть только у failed и policy_flagged. Остальным приходит null.