Монтаж и цена

Монтаж — главная операция Slicer: ИИ-режиссёр смотрит материалы, выбирает лучшие моменты, расставляет субтитры, эмодзи, плашки и движение камеры и собирает вертикальный ролик. Через API монтаж запускается одним запросом POST /v1/projects — с обязательным подтверждением цены. Если ролик вы собираете сами, создайте проект без ИИ-режиссёра — это бесплатно.

Настройки ролика#

Все настройки необязательны: недостающие берутся по умолчанию, как в приложении. Допустимые значения и их описания на двух языках — в каталоге GET /v1/styles.

{
  "uploadIds": ["7d0c6a4e-2f7b-4f5e-9a0e-3b8f2c1d9e61", "a1b2c3d4-0000-4c1e-8f00-5e6f7a8b9c0d"],
  "title": "Обзор новой коллекции",
  "brief": "Начни с самого яркого образа, в конце — призыв подписаться",
  "settings": {
    "templateId": "bold",
    "fontId": "punch",
    "colorId": "azure",
    "subtitles": { "enabled": true, "design": "dynamic", "size": "medium", "position": "auto" },
    "params": { "emoji": true, "soundEffects": true, "mediaCards": false, "plaques": true, "cameraMotion": true, "hook": true },
    "smartCut": true,
    "targetDurationSec": 30,
    "language": "auto",
    "direction": { "mode": "product", "pace": "dynamic", "effects": "light", "narration": false }
  }
}

Полная схема настроек:

Неизвестные значения ("fontId": "comic") заменяются значениями по умолчанию, ошибки не будет. Пожелания brief — это данные для режиссёра, а не команды: они не могут изменить формат результата или правила монтажа.

Цена до запуска#

Платные операции API устроены одинаково: первый запрос называет цену, второй — с согласием — запускает.

1. Запрос без confirmCost — цена

   { "ok": true, "data": { "status": "quote", "cost": 24, "free": false, "available": 240, "enough": true, "spendLimitLeft": 176 } }

   Ничего не создано и не списано. enough учитывает и баланс, и остаток лимита расходов токена. Если ещё доступен бесплатный первый ролик, придёт "cost": 0, "free": true — его тоже нужно подтвердить: "confirmCost": 0.

2. Тот же запрос с confirmCost — запуск

   Добавьте "confirmCost": 24 и заголовок Idempotency-Key. Ответ — созданный проект со статусом queued.

Узнать цену, не готовя тело запроса, можно через POST /v1/estimate с kind: montage, remount, retry (с projectId), assistant, translate или transcribe — субтитры из речи проекта (с projectId, по умолчанию — все исходники, где речь ещё не распознана). Монтаж стоит 24 токена за ролик до 90 секунд; полный прайс — в GET /v1/styles → pricing и в разделе Цены операций.

Субтитры из речи, ИИ-помощник и перевод субтитров работают по себестоимости ИИ без наценки: в их цене есть ожидаемая сумма (estimate) и предельная (cost), а atCost: true. Подтверждается предельная, списывается фактическая, не больше её (Правки ролика).

Как идёт работа#

GET /v1/projects/{id} показывает, что происходит. Опрашивайте раз в 5 секунд или подпишитесь на вебхуки.

При запуске токены резервируются, при успехе — списываются, при ошибке или остановке резерв возвращается на баланс.

Версии ролика#

Монтаж отдаёт одну версию. Собрав ролик, режиссёр сам пересматривает готовый результат, исправляет порядок и логику — и только потом проект становится succeeded. Выбирать ничего не нужно: versionChoice — null, готовая версия сразу текущая.

Каждая пересборка, повтор или смена стиля добавляют новую версию, прежние остаются в versions[] (новые — первыми):

{
  "status": "succeeded",
  "versionChoice": null,
  "versions": [
    { "id": 905, "version": 2, "idea": null, "durationSec": 29.6, "current": true, "awaitingChoice": false, "hasFile": true },
    { "id": 901, "version": 1, "idea": null, "durationSec": 31.4, "current": false, "awaitingChoice": false, "hasFile": true }
  ]
}

• Посмотреть версию — GET /v1/projects/{id}/result?version=901.
• Вернуть прежнюю — POST /v1/projects/{id}/versions/901/choose: версия становится текущей, правки и экспорт дальше идут от неё, а ролик, который был текущим, остаётся в истории. Так же работает Сделать текущей в приложении.

Последние 10 версий проекта хранятся с файлами (hasFile), их список — GET /v1/projects/{id}/versions. Вернуть версию без файла нельзя — ответ 404 version_not_found.

Пересборка, повтор и остановка#

Повтор продолжает с первого неудавшегося этапа, а не с нуля. Если не удались экспорт или смена стиля, проект остаётся готовым с прежним роликом.

Пока над проектом идёт работа, новый запуск вернёт 409 busy. Журнал всех работ проекта — GET /v1/projects/{id}/history.

Проект без ИИ-режиссёра#

Если ролик собираете вы сами — своим кодом или своим ИИ-ассистентом, — создайте проект в режиме manual, как Сам в редакторе в приложении. Это бесплатно: режиссёр не монтирует, материалы ложатся на таймлайн как есть, а дальше ролик правится операциями. Инструмент MCP create_project по умолчанию создаёт именно такой проект (MCP-сервер); у POST /v1/projects режим по умолчанию — ai.

{
  "uploadIds": ["7d0c6a4e-2f7b-4f5e-9a0e-3b8f2c1d9e61", "a1b2c3d4-0000-4c1e-8f00-5e6f7a8b9c0d"],
  "mode": "manual",
  "format": "9:16",
  "title": "Утро в кофейне"
}

• confirmCost не нужен — ответ сразу проект. settings и brief в этом режиме не используются.
• format — формат кадра: 9:16 (по умолчанию), 4:5, 1:1, 16:9.
• Материалы ложатся по порядку: видео — целиком, фото — по 3 секунды, музыка — на дорожку музыки, озвучка — на дорожку голоса. Если пропорции материала не совпадают с форматом, кадр вписывается целиком на размытом фоне.
• Проект проходит короткую подготовку без ИИ (queued → processing, обычно секунды) и получает статус draft — черновик. Дождитесь его опросом GET /v1/projects/{id}.

1. Прочитайте ролик

   GET /v1/projects/{id}/transcript. Речь в черновике не распознана: фрагменты — по времени (kind: "range"), а элементы ставятся по времени ролика (Элементы по времени). Нужны субтитры — распознайте речь (POST /v1/projects/{id}/transcribe, по себестоимости за минуту звука): после этого субтитры идут за речью, а в тексте ролика появляются слова с id.

2. Соберите ролик операциями

   POST /v1/projects/{id}/edits — разделить, подрезать, переставить и удалить фрагменты, убрать паузы (cut_silences), добавить хук, титры, плашки, наезды, переходы и цвет, поставить музыку и голос. Правки бесплатны.

3. Экспортируйте

   POST /v1/projects/{id}/export (Экспорт и публикация). Первый удачный экспорт переводит проект в succeeded; если экспорт не удался, проект остаётся черновиком.

Что дальше#