Правки ролика

Готовый ролик или черновик проекта без ИИ-режиссёра можно править так же, как в редакторе приложения: вырезать слова и паузы, разделить, подрезать, переставить и дублировать фрагменты, поставить стоп-кадр, исправить субтитры, добавить хук, плашки, титры, эмодзи, наезды и маркеры, поменять скорость (и кривую скорости), звук, переходы, эффекты и цвет, кадр, маску, хромакей и ключевые кадры, поставить музыку и голос, свои фото и видео поверх ролика — во весь кадр или окном, поменять обложку и формат кадра. Правки бесплатны и сразу видны в редакторе; файл ролика обновляет экспорт. Платные — только ИИ-функции Slicer: субтитры из речи, ИИ-помощник и перевод субтитров, все по себестоимости. Смонтировать ролик целиком ваш агент может и сам, бесплатно: он пишет план, а Slicer применяет к нему правила своего ИИ-режиссёра — Свой режиссёр.

Как устроены правки#

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

   GET /v1/projects/{id}/transcript отдаёт ролик как текст: фрагменты по порядку, в них слова с id, отметки вырезанных и выделенных слов, и элементы — с привязкой к словам или ко времени ролика.

   {
     "rev": 7,
     "durationSec": 31.4,
     "text": "…",
     "blocks": [
       {
         "id": "b1",
         "position": 0,
         "sourceIndex": 0,
         "kind": "words",
         "words": [
           { "id": 12, "text": "Сегодня", "cut": false, "accent": false },
           { "id": 13, "text": "покажу", "cut": false, "accent": false },
           { "id": 14, "text": "эээ", "cut": true, "accent": false },
           { "id": 15, "text": "монтаж", "cut": false, "accent": true }
         ]
       },
       { "id": "b2", "position": 1, "sourceIndex": 2, "kind": "range", "words": [] }
     ],
     "elements": {
       "hook": "Монтаж за 3 минуты",
       "plaques": [],
       "cards": [],
       "emoji": [{ "id": "e1", "emoji": "🚀", "wordId": 15, "start": 1.2, "end": 2.4 }],
       "zooms": [{ "id": "z1", "fromWordId": 12, "toWordId": 15, "start": 0, "end": 2.4 }],
       "titles": [
         {
           "id": "t1", "text": "Шаг 1", "font": "punch", "size": 96, "color": "#FFFFFF", "background": "pill",
           "align": "center", "x": 540, "y": 420, "fromWordId": null, "toWordId": null,
           "start": 8, "end": 11, "anchor": { "blockId": "b2", "at": 3.5, "duration": 3 }
         }
       ],
       "markers": [{ "id": "m1", "time": 12.5, "label": "Сюда музыку", "color": "yellow" }]
     }
   }

   • kind: "words" — фрагмент речи со словами; kind: "range" — фрагмент по времени исходника: видеоряд, фото или ролик без распознанной речи. Слов в нём может не быть.
   • start и end у элементов — где элемент стоит в ролике, в секундах. Нет start — элемент сейчас не виден (его слова вырезаны).
   • Элемент, поставленный по времени, а не на слова, приходит с fromWordId: null и привязкой anchor — фрагмент, секунда его исходника и длительность (Элементы по времени).
   • markers — пометки автора на таймлайне, в ролик они не попадают.

   Поле text — тот же ролик одной строкой в форме, удобной для языковой модели: его можно передать своему ИИ-агенту, чтобы он предложил правки. Фрагменты без речи показаны в нём со временем в ролике.

2. Отправьте операции

   POST /v1/projects/{id}/edits с ревизией rev из шага 1 и списком операций (до 80 за раз):

   {
     "rev": 7,
     "operations": [
       { "op": "cut_fillers" },
       { "op": "set_hook", "text": "Монтаж за 3 минуты" },
       { "op": "set_accent", "wordId": 18 },
       { "op": "set_emoji", "wordId": 18, "emoji": "🔥" },
       { "op": "add_plaque", "fromWordId": 20, "toWordId": 26, "kind": "list", "text": "Три шага", "caption": "Загрузить\nВыбрать стиль\nЭкспорт" },
       { "op": "add_title", "start": 8, "duration": 3, "text": "Шаг 1", "titleBackground": "pill", "titleIn": "pop" },
       { "op": "tune_block", "id": "b3", "transition": { "kind": "dissolve", "duration": 0.4 }, "animIn": { "kind": "zoomIn", "duration": 0.5 } }
     ]
   }

   { "ok": true, "data": { "rev": 8, "applied": 7, "skipped": [], "durationSec": 29.8 } }

3. Экспортируйте, когда правки закончены

   Правки сохраняются сразу. Чтобы получить обновлённый файл, запустите экспорт — он бесплатный.

Операции#

Каталог операций один на весь Slicer: те же операции применяют ручные правки в редакторе, ИИ-помощник, режиссёр в «Чате», API и MCP-инструмент edit_project. Поэтому результат совпадает с тем, что вы получили бы в редакторе.

Слова адресуются id из текста ролика, фрагменты и элементы — своими id. Диапазон слов — fromWordId…toWordId включительно, позиция фрагмента — с 0.

Речь и фрагменты#

Настройки фрагментов и всего ролика#

Кадр, маска, скорость и звук по времени#

С версии API 1.5.0.

[
  { "op": "set_speed_curve", "id": "b4", "preset": "bullet" },
  { "op": "set_smooth", "id": "b4", "on": true },
  { "op": "set_keyframe", "id": "b5", "t": 0, "rotate": 0 },
  { "op": "set_keyframe", "id": "b5", "t": 2.5, "rotate": 12, "scale": 1.2 }
]

Субтитры#

Элементы#

Элементы ставятся на слова (fromWordId, toWordId или wordId) или — где речи нет — по времени ролика (start, duration).

Музыка и голос#

С версии API 1.7.0. Трек и запись голоса — исходник проекта (sourceIndex) или файл из медиа проекта (uploadId — свои файлы, добавленные к проекту в редакторе). id записей голоса — в документе монтажа, список voices.

[
  { "op": "set_music", "sourceIndex": 3, "volume": 0.25, "ducking": true, "fadeOut": 1.5 },
  { "op": "fit_music", "on": true },
  { "op": "fit_to_beats", "every": 2 }
]

Свои фото и видео поверх ролика#

С версии API 1.7.0. Вставка закрывает картинку ролика фото или видео, пока идёт речь, — например, чтобы показать то, о чём говорит автор. Ставится на слова или по времени, как элементы; id вставок — в документе монтажа, список inserts.

{ "op": "add_insert", "sourceIndex": 2, "fromWordId": 40, "toWordId": 52, "mode": "pip" }

Картинка в картинке#

С версии API 1.6.0. Вставка — своё фото или видео поверх ролика (её id — в документе монтажа, список inserts) — может закрывать весь кадр или стоять окном.

{ "op": "set_pip", "id": "i4k2m9q", "x": 800, "y": 1500, "scale": 0.4, "shape": "circle", "borderColor": "#ffffff", "borderWidth": 0.03 }

Ключевые кадры окна задаются в редакторе; в документе монтажа они — inserts[].pip.keyframes.

Значения#

• speed — от 0,25 до 4; volume — от 0 до 1; fadeIn, fadeOut — от 0 до 3 секунд;
• effect — shake, pulse, flash, cinema, vignette, grain, blur, glitch, vhs;
• transition — { "kind", "duration" }, длительность — от 0,2 до 1,2 секунды; вид — fade, flash, zoom, dissolve, blur, сдвиги slide, slideRight, slideUp, slideDown, шторки wipe, wipeRight, wipeUp, wipeDown, круг circleOpen и circleClose, zoomIn, pixelize, radial, scatter;
• filter — { "id", "strength" }, фильтр — bw, warm, cool, vintage, sepia, vivid, pastel, noir, cinema, сила — от 0 до 1;
• adjust — «Настроить»: exposure, brightness, contrast, saturation, temperature, tint, каждое от −1 до 1 (0,15 — заметный шаг); заменяет все ползунки фрагмента сразу;
• lut — { "preset", "strength" } или { "uploadId", "strength" }: встроенный LUT — teal-orange, film, matte, bleach, golden, moody, nordic, cross, mono-film, vibrant; uploadId — свой .cube из «Мои LUT» (его id виден в документе монтажа у фрагмента с этим LUT); сила — от 0 до 1;
• animIn, animOut — { "kind", "duration" }, вид — fade, zoomIn, zoomOut, slideLeft, slideRight, slideUp, slideDown, длительность — от 0,2 до 2 секунд.

Оформление титра — поля с префиксом title; у update_title null сбрасывает поле:

Полная схема операций:

Элементы по времени#

В ролике без речи — видеоряд, фото, черновик без распознанной речи — слов нет, поэтому плашки, титры, эмодзи, наезды, карточки и маркеры ставятся по времени: start — секунда ролика, duration — длительность в секундах ролика (0,3–60).

{ "op": "add_title", "start": 4, "duration": 2.5, "text": "Утро в кофейне", "titleIn": "typewriter" }

{ "op": "add_zoom", "start": 9, "duration": 2, "scale": 1.2, "motion": "pull" }

Элемент держится за фрагмент, над которым стоит, — как присоединённый клип: переставите фрагмент — элемент переедет с ним, удалите фрагмент — элемент уйдёт вместе с ним. Над речью лучше ставить элементы на слова: такая привязка переживает правку текста. Если у операции есть и слова, и время, берутся слова.

Пропущенные операции#

Операции применяются по порядку. Если операция ничего не меняет — слово не найдено, фрагмента нет, эмодзи не из набора, — она пропускается, а остальные применяются. Пропущенные перечислены в skipped:

{ "rev": 9, "applied": 2, "skipped": [{ "index": 1, "op": "remove_plaque", "reason": "element_not_found" }], "durationSec": 29.8 }

Ревизии#

У ролика есть номер ревизии rev; каждая сохранённая правка увеличивает его. Правка с устаревшей ревизией отклоняется с 409 stale_document — значит, ролик успели изменить в редакторе или другим запросом. Перечитайте текст ролика и повторите правку с новой rev. Так правки из API и из приложения не затирают друг друга.

Субтитры из речи#

В проекте без ИИ-режиссёра речь не распознана, поэтому субтитров нет, а фрагменты в тексте ролика — по времени. POST /v1/projects/{id}/transcribe распознаёт речь исходников — как Субтитры из речи в редакторе (Субтитры из речи). Так же можно распознать исходники, которые добавили в проект после монтажа.

curl https://api.slicer.media/v1/projects/318/transcribe \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"language":"auto"}'

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

Распознавание идёт в фоне. Ответ на запуск — задача { id, status, sources, createdAt }; её ход — GET /v1/projects/{id}/transcribe, список задач проекта:

Когда задача готова, перечитайте GET /v1/projects/{id}/transcript: у фрагментов появятся слова с id, на них можно ставить элементы и править субтитры (set_text, set_accent, set_phrase_text). Сам документ монтажа при этом не меняется. Цену заранее называет POST /v1/estimate с kind: "transcribe" и projectId.

ИИ-помощник#

Команда своими словами — помощник сам подберёт операции из того же каталога:

curl https://api.slicer.media/v1/projects/318/assistant \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"Сделай ролик динамичнее и добавь эмодзи на ключевых словах","rev":9}'

Помощник работает по себестоимости: команда стоит ровно столько, сколько стоили вызовы ИИ, без наценки. Без confirmCost придёт цена:

{ "ok": true, "data": { "status": "quote", "cost": 2, "free": false, "estimate": 0.4, "atCost": true, "available": 240, "enough": true, "spendLimitLeft": 176 } }

• atCost: true — операция по себестоимости;
• estimate — ожидаемая цена в токенах, дробно;
• cost — предельная цена: повторите запрос с "confirmCost", равным ей. Спишется фактическая себестоимость, но не больше cost.

С confirmCost ответ — { rev, summary, applied, charged, costTokens, durationSec }: summary — что сделано, costTokens — фактическая себестоимость команды (дробно), charged — сколько целых токенов списано с баланса сейчас. Дробный остаток копится у проекта и спишется, когда наберётся целый токен. Токены списываются, только если помощник что-то изменил. Нужна область montage:run.

Перевод субтитров#

POST /v1/projects/{id}/translate с language — en, es, pt, de, fr, it, pl, tr, id, uk, ru — и rev. Перевод раскладывается по словам, поэтому акценты и эмодзи остаются на месте. Перевод тоже работает по себестоимости: цена (Quote с estimate и cost) и подтверждение — как у помощника. В ответе — { rev, phrases, charged, costTokens }; списывается, только если перевод получился.

Автобаланс цвета#

POST /v1/projects/{id}/auto-color выравнивает цвет без ИИ и бесплатно — по 10 кадрам фрагмента, как кнопки Авто и Как у этого — ко всем в редакторе. В теле — rev, blockId и mode:

• auto — поправить фрагмент blockId: экспозиция, контраст, насыщенность и баланс белого;
• match — сделать остальные фрагменты похожими на blockId: им ставятся его фильтр и LUT, а «Настроить» подбирается каждому своё.

{ "rev": 7, "blockId": "b2", "mode": "match" }

Результат сразу сохраняется. В ответе — новая ревизия, значения «Настроить» по id фрагментов (adjust), сколько фрагментов изменено (applied) и длительность ролика.

Свой режиссёр#

Ваш ИИ-агент может смонтировать ролик сам — на своей стороне, для Slicer бесплатно: он смотрит кадры и пишет план, а Slicer применяет к плану правила своего ИИ-режиссёра на сервере и отвечает исправлениями и замечаниями. Сами правила агенту не передаются. Как это устроено по шагам — Свой режиссёр в разделе MCP: инструменты get_director_brief, get_frames и submit_director_plan построены на этих маршрутах.

Все три бесплатны. Если в ролике есть речь, сначала распознайте её — Субтитры из речи (по себестоимости): без слов режиссёру нечего резать.

Бриф#

Тело необязательно: настройки режиссуры — mode (auto, talking, story, product, aesthetic), pace (calm, balanced, dynamic), effects (off, light, bold), targetDurationSec (10–180, null — решает режиссёр, до 90 секунд), hook, plaques, emoji, cameraMotion. Переданные поля сохраняются в проекте: по ним Slicer применяет правила к плану.

curl https://api.slicer.media/v1/projects/318/director/brief \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pace":"dynamic","targetDurationSec":30}'

Кадры#

times — секунды исходника через запятую (до 16), или равномерно: from, to, count (по умолчанию 8 кадров на весь исходник). Секунды за пределами исходника подтягиваются к его краю. Фото отдаёт одну картинку; у аудио кадров нет (400 no_picture), нет такого исходника — 404 source_not_found.

curl "https://api.slicer.media/v1/projects/318/sources/0/frames?times=2.5,7,12.4" \
  -H "Authorization: Bearer $SLICER_TOKEN"

{ "ok": true, "data": { "sourceIndex": 0, "durationSec": 48.2, "frames": [{ "time": 2.5, "mimeType": "image/jpeg", "data": "/9j/4AAQ…" }] } }

План#

В теле — rev (из брифа или из прошлого ответа), plan по planSchema и, по желанию, scenes — до 400 наблюдений по scenesSchema: sourceIndex, start и end в секундах исходника, kind (talking_head, demo, people, screen, broll, unusable), interest от 1 до 5 и description. Что значат виды и как Slicer ставит по ним видеоряд — Наблюдения по кадрам.

{
  "rev": 3,
  "plan": {
    "concept": "Три шага от молока до рисунка",
    "segments": [
      { "kind": "speech", "role": "hook", "fromWordId": 41, "toWordId": 47, "why": "Сильное начало" },
      { "kind": "footage", "role": "body", "sourceIndex": 0, "fromSec": 14.5, "toSec": 19, "why": "Показ рисунка" }
    ],
    "hook": "Латте-арт за минуту"
  },
  "scenes": [
    { "sourceIndex": 0, "start": 0, "end": 14.5, "kind": "talking_head", "interest": 3, "description": "Бариста рассказывает у стойки" },
    { "sourceIndex": 0, "start": 14.5, "end": 21, "kind": "demo", "interest": 5, "description": "Рисует сердце на латте" }
  ]
}

На сервере к плану применяются правила режиссёра Slicer: речь — по словам, видеоряд — по наблюдениям, сдержанный монтаж, длина. План сразу становится роликом — новой ревизией, даже если к нему есть замечания. Медиа-карточки по описанию не принимаются — их картинка платная; своё фото ставит операция update_card. Кадр фрагментов — по центру, правится операцией set_framing.

Замечания к плану#

Замечание — { code, segment, message }: код, номер фрагмента плана с нуля (только если замечание о фрагменте) и что поправить — на английском, его читает модель. Поправьте план и пришлите его целиком снова с новой rev; когда issues пуст, план в порядке.

Стиль#

PATCH /v1/projects/{id}/style меняет шаблон, шрифт, акцентный цвет, вид субтитров, звуковые эффекты и наезд в начале — бесплатно. Правка частичная: меняются только переданные поля, остальное — в том числе другие поля subtitles и params — остаётся как было.

{ "templateId": "clean", "fontId": "editorial", "colorId": "mint", "subtitles": { "design": "karaoke", "size": "large" } }

Новый стиль виден в редакторе сразу, в файле — после экспорта. Чтобы ИИ заново собрал ролик с другими параметрами монтажа, нужна пересборка.

Вид субтитров#

Поля subtitles — те же, что в шторке Стиль субтитров редактора (Субтитры). Выделение слова, появление, слов на экране, регистр и цвет по говорящим — с версии API 1.8.0.

У highlight, animation, words и letterCase есть и auto — значение по умолчанию: как задумано оформлением (у letterCase — шрифтом). Шаблоны — bold, clean и pop.

{ "subtitles": { "highlight": "pop" } }

Как ведёт себя правка subtitles:

• меняются только переданные поля, остальные остаются как были. До версии 1.8.0 частичная правка subtitles сбрасывала остальные поля к значениям по умолчанию;
• новое design без highlight, animation и words возвращает их к auto — как выбор оформления в редакторе: оформление сразу выглядит так, как задумано. Размер, положение, регистр и цвет по говорящим остаются. Чтобы сменить оформление и сразу задать выделение, передайте оба поля:

{ "subtitles": { "design": "karaoke", "highlight": "pop" } }

Названия и описания значений на двух языках — в каталоге GET /v1/styles: оформления — subtitleDesigns, положения — subtitlePositions, выделение слова, появление, слов на экране и регистр — subtitleOptions:

[
  {
    "id": "highlight",
    "title": { "ru": "Выделение слова", "en": "Word highlight" },
    "help": { "ru": "Как выделяется слово, которое сейчас звучит.", "en": "How the word being spoken is highlighted." },
    "values": [
      { "id": "auto", "title": { "ru": "Как в оформлении", "en": "As in the style" }, "description": { "ru": "Так, как задумано выбранным оформлением.", "en": "As the chosen style intends." } },
      { "id": "pop", "title": { "ru": "Увеличение", "en": "Pop" }, "description": { "ru": "Слово, которое звучит, увеличивается и подсвечивается, соседние слова плавно расступаются.", "en": "The spoken word grows and lights up, the others smoothly make room." } }
    ]
  }
]

Те же поля принимают settings.subtitles при создании проекта (Настройки ролика) и MCP-инструмент set_style.

Документ монтажа (для продвинутых)#

GET /v1/projects/{id}/document отдаёт весь документ монтажа — полное описание ролика, из которого строятся превью и рендер, — с ревизией. PUT того же адреса с { rev, document } заменяет его целиком. Документ проходит те же проверки, что правки из редактора; неизвестные поля отбрасываются.

Пример: убрать паразиты и поставить хук#

// node polish.mjs 318
const API = 'https://api.slicer.media/v1';
const headers = { Authorization: `Bearer ${process.env.SLICER_TOKEN}`, 'Content-Type': 'application/json' };
const id = process.argv[2];

async function call(method, path, body) {
  const response = await fetch(`${API}${path}`, { method, headers, body: body && JSON.stringify(body) });
  const json = await response.json();
  if (!json.ok) throw Object.assign(new Error(json.error.message), { code: json.error.code });
  return json.data;
}

for (let attempt = 0; attempt < 3; attempt += 1) {
  const { rev, blocks } = await call('GET', `/projects/${id}/transcript`);
  const words = blocks.flatMap((block) => block.words).filter((word) => !word.cut);
  try {
    const result = await call('POST', `/projects/${id}/edits`, {
      rev,
      operations: [
        { op: 'cut_fillers' },
        { op: 'set_hook', text: 'Монтаж за 3 минуты' },
        { op: 'set_accent', wordId: words[0].id },
      ],
    });
    console.log(`Применено: ${result.applied}, длительность: ${result.durationSec} с`);
    break;
  } catch (error) {
    if (error.code !== 'stale_document') throw error; // ролик изменили — перечитать и повторить
  }
}

# python polish.py 318
import os
import sys

import requests

API = "https://api.slicer.media/v1"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['SLICER_TOKEN']}"
project_id = sys.argv[1]


class ApiError(Exception):
    def __init__(self, error):
        super().__init__(error["message"])
        self.code = error["code"]


def call(method, path, json=None):
    body = session.request(method, API + path, json=json, timeout=60).json()
    if not body["ok"]:
        raise ApiError(body["error"])
    return body["data"]


for attempt in range(3):
    transcript = call("GET", f"/projects/{project_id}/transcript")
    words = [w for block in transcript["blocks"] for w in block["words"] if not w["cut"]]
    try:
        result = call("POST", f"/projects/{project_id}/edits", {
            "rev": transcript["rev"],
            "operations": [
                {"op": "cut_fillers"},
                {"op": "set_hook", "text": "Монтаж за 3 минуты"},
                {"op": "set_accent", "wordId": words[0]["id"]},
            ],
        })
        print(f"Применено: {result['applied']}, длительность: {result['durationSec']} с")
        break
    except ApiError as error:
        if error.code != "stale_document":  # ролик изменили — перечитать и повторить
            raise

Что дальше#