Правки

Эндпоинты правок в Slicer API — текст ролика с id слов, операции, документ монтажа, субтитры из речи, ИИ-помощник, перевод, стиль, свой режиссёр.

На этой странице

Ролик текстом с id слов
Применить правки
Субтитры из речи
Задачи распознавания речи
Команда ИИ-помощнику
Перевести субтитры
Автобаланс и подбор цвета (бесплатно)
Сменить стиль
Свой режиссёр
Бриф режиссёра для вашего ИИ-ассистента (бесплатно)
Кадры исходника (бесплатно)
Применить план режиссёра (бесплатно)
Документ монтажа
Документ монтажа
Заменить документ монтажа (для продвинутых)
Схемы

Правки меняют ролик так же, как редактор приложения, и сохраняются сразу. Бесплатны все, кроме субтитров из речи, ИИ-помощника и перевода субтитров — они стоят по себестоимости ИИ (Субтитры из речи, ИИ-помощник). Каждая правка передаёт ревизию rev: если ролик успели изменить, ответ — 409 stale_document. Как этим пользоваться — в руководстве Правки ролика.

Ролик текстом с id слов

GET/v1/projects/{id}/transcript

Области доступа: projects:read
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/transcript" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/projects/42/transcript', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/transcript",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: Transcript (90)

Поле	Тип	Описание
`rev`обязательное	`integer`	Ревизия документа: передайте её в правки
`durationSec`обязательное	`number`
`text`обязательное	`string`	Ролик текстом для LLM: фрагменты со словами `w<id>`, вырезанное — в [скобках], графика
`blocks`обязательное	`object[]`
`blocks[].id`обязательное	`string`
`blocks[].position`обязательное	`integer`
`blocks[].sourceIndex`обязательное	`integer`
`blocks[].kind`обязательное	`string`	`words` · `range`
`blocks[].words`обязательное	`object[]`
`blocks[].words[].id`обязательное	`integer`
`blocks[].words[].text`обязательное	`string`
`blocks[].words[].cut`обязательное	`boolean`
`blocks[].words[].accent`обязательное	`boolean`
`elements`обязательное	`object`
`elements.hook`обязательное	`string \| null`
`elements.plaques`обязательное	`object[]`
`elements.plaques[].id`обязательное	`string`
`elements.plaques[].kind`обязательное	`string`
`elements.plaques[].title`обязательное	`string`
`elements.plaques[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.plaques[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.plaques[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.plaques[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.plaques[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.plaques[].anchor.blockId`обязательное	`string`
`elements.plaques[].anchor.at`обязательное	`number`
`elements.plaques[].anchor.duration`обязательное	`number`
`elements.cards`обязательное	`object[]`
`elements.cards[].id`обязательное	`string`
`elements.cards[].caption`обязательное	`string \| null`
`elements.cards[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.cards[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.cards[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.cards[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.cards[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.cards[].anchor.blockId`обязательное	`string`
`elements.cards[].anchor.at`обязательное	`number`
`elements.cards[].anchor.duration`обязательное	`number`
`elements.emoji`обязательное	`object[]`
`elements.emoji[].id`обязательное	`string`
`elements.emoji[].emoji`обязательное	`string`
`elements.emoji[].wordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.emoji[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.emoji[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.emoji[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.emoji[].anchor.blockId`обязательное	`string`
`elements.emoji[].anchor.at`обязательное	`number`
`elements.emoji[].anchor.duration`обязательное	`number`
`elements.zooms`обязательное	`object[]`
`elements.zooms[].id`обязательное	`string`
`elements.zooms[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.zooms[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.zooms[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.zooms[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.zooms[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.zooms[].anchor.blockId`обязательное	`string`
`elements.zooms[].anchor.at`обязательное	`number`
`elements.zooms[].anchor.duration`обязательное	`number`
`elements.titles`обязательное	`object[]`	Свободные текстовые слои (титры)
`elements.titles[].id`обязательное	`string`
`elements.titles[].text`обязательное	`string`
`elements.titles[].font`обязательное	`string`
`elements.titles[].size`обязательное	`number`
`elements.titles[].color`обязательное	`string`
`elements.titles[].background`обязательное	`string`	`none` · `box` · `pill`
`elements.titles[].backgroundColor`	`string`
`elements.titles[].outline`	`boolean`
`elements.titles[].shadow`	`boolean`
`elements.titles[].align`обязательное	`string`	`left` · `center` · `right`
`elements.titles[].x`обязательное	`number`
`elements.titles[].y`обязательное	`number`
`elements.titles[].animIn`	`string`	`fade` · `slide` · `pop` · `typewriter`
`elements.titles[].animOut`	`string`	`fade` · `slide` · `pop`
`elements.titles[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.titles[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.titles[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.titles[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.titles[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.titles[].anchor.blockId`обязательное	`string`
`elements.titles[].anchor.at`обязательное	`number`
`elements.titles[].anchor.duration`обязательное	`number`
`elements.markers`обязательное	`object[]`	Маркеры автора на таймлайне (в ролик не попадают); отрезанные не показываются
`elements.markers[].id`обязательное	`string`
`elements.markers[].time`обязательное	`number`
`elements.markers[].label`обязательное	`string \| null`
`elements.markers[].color`обязательное	`string`	`cyan` · `yellow` · `red` · `green` · `violet`
`elements.sounds`обязательное	`object[]`	Звуковые эффекты, которые поставил автор; отрезанные не показываются
`elements.sounds[].id`обязательное	`string`
`elements.sounds[].kind`обязательное	`string`	`whoosh` · `pop` · `ding` · `click` · `swipe` · `rise` · `boom` · `chime`
`elements.sounds[].time`обязательное	`number`

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "durationSec": 42.5,
    "text": "string",
    "blocks": [
      {
        "id": "string",
        "position": 1,
        "sourceIndex": 1,
        "kind": "words",
        "words": [
          {
            "id": null,
            "text": null,
            "cut": null,
            "accent": null
          }
        ]
      }
    ],
    "elements": {
      "hook": "string",
      "plaques": [
        {
          "id": "string",
          "kind": "string",
          "title": "Монтаж за 3 минуты",
          "fromWordId": null,
          "toWordId": null,
          "start": 1.5,
          "end": 1.5,
          "anchor": {
            "blockId": null,
            "at": null,
            "duration": null
          }
        }
      ],
      "cards": [
        {
          "id": "string",
          "caption": "string",
          "fromWordId": null,
          "toWordId": null,
          "start": 1.5,
          "end": 1.5,
          "anchor": {
            "blockId": null,
            "at": null,
            "duration": null
          }
        }
      ],
      "emoji": [
        {
          "id": "string",
          "emoji": "string",
          "wordId": null,
          "start": 1.5,
          "end": 1.5,
          "anchor": {
            "blockId": null,
            "at": null,
            "duration": null
          }
        }
      ],
      "zooms": [
        {
          "id": "string",
          "fromWordId": null,
          "toWordId": null,
          "start": 1.5,
          "end": 1.5,
          "anchor": {
            "blockId": null,
            "at": null,
            "duration": null
          }
        }
      ],
      "titles": [
        {
          "id": "string",
          "text": "string",
          "font": "string",
          "size": 104857600,
          "color": "string",
          "background": "none",
          "backgroundColor": "string",
          "outline": true,
          "shadow": true,
          "align": "left",
          "x": 1.5,
          "y": 1.5,
          "animIn": "fade",
          "animOut": "fade",
          "fromWordId": null,
          "toWordId": null,
          "start": 1.5,
          "end": 1.5,
          "anchor": {
            "blockId": null,
            "at": null,
            "duration": null
          }
        }
      ],
      "markers": [
        {
          "id": "string",
          "time": 1.5,
          "label": "string",
          "color": "cyan"
        }
      ],
      "sounds": [
        {
          "id": "string",
          "kind": "whoosh",
          "time": 1.5
        }
      ]
    }
  }
}

Применить правки

POST/v1/projects/{id}/edits

Области доступа: projects:write
Лимит: обычный

Бесплатно. Id слов — из GET …/transcript. Неприменимые операции пропускаются и перечисляются в skipped.

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `EditsRequest`

Поле	Тип	Описание
`rev`обязательное	`integer`	Ревизия из GET …/transcript или …/document
`operations`обязательное	`EditOperation[]`	1–80

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/edits" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rev":7,"operations":[{"op":"cut_words","fromWordId":42,"toWordId":42}]}'

const response = await fetch('https://api.slicer.media/v1/projects/42/edits', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "rev": 7,
    "operations": [
      {
        "op": "cut_words",
        "fromWordId": 42,
        "toWordId": 42
      }
    ]
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/edits",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "rev": 7,
        "operations": [{
            "op": "cut_words",
            "fromWordId": 42,
            "toWordId": 42,
        }],
    },
)
body = response.json()

Ответ

Поля ответа: EditsResult (7)

Поле	Тип	Описание
`rev`обязательное	`integer`
`applied`обязательное	`integer`
`skipped`обязательное	`object[]`
`skipped[].index`обязательное	`integer`
`skipped[].op`обязательное	`string`
`skipped[].reason`обязательное	`string`
`durationSec`обязательное	`number`

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "applied": 1,
    "skipped": [
      {
        "index": 1,
        "op": "string",
        "reason": "string"
      }
    ],
    "durationSec": 42.5
  }
}

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

POST/v1/projects/{id}/transcribe

Области доступа: montage:run
Лимит: платные операции
Цена: тратит токены

Распознаёт речь исходников проекта (ручной проект или новые исходники) — по себестоимости ИИ за минуту звука. Без confirmCost — цена. Идёт в фоне: ход — GET …/transcribe; когда готово, слова — в тексте ролика, субтитры идут за речью.

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `TranscribeRequest`

Поле	Тип	Описание
`sources`	`integer[]`	Номера исходников (по умолчанию — все со звуком, где речь ещё не распознана)1–40
`language`	`string`	Язык речи: auto или двухбуквенный код
`confirmCost`	`integer`	Цена, на которую вы согласны. Без неё ответ — `Quote`, ничего не запускается

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/transcribe" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sources":[1],"language":"ru"}'

const response = await fetch('https://api.slicer.media/v1/projects/42/transcribe', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "sources": [
      1
    ],
    "language": "ru"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/transcribe",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "sources": [1],
        "language": "ru",
    },
)
body = response.json()

Ответ

Один из вариантов: Quote, TranscribeJob

Поля ответа: Quote (8)

Поле	Тип	Описание
`status`обязательное	`"quote"`
`cost`обязательное	`integer`	Цена в токенах; повторите запрос с `confirmCost`, равным ей. У операции по себестоимости (`atCost`) — предельная: спишется фактическая себестоимость, не больше
`free`обязательное	`boolean`	Операция бесплатна (первый ролик, бесплатный повтор)
`estimate`	`number`	Операция по себестоимости: ожидаемая цена в токенах (дробно)
`atCost`	`boolean`	Цена — себестоимость ИИ-сервисов без наценки: списывается фактическая, не больше `cost`
`available`обязательное	`integer`	Сколько токенов доступно сейчас
`enough`обязательное	`boolean`	Токенов хватает
`spendLimitLeft`обязательное	`integer \| null`	Остаток месячного лимита расходов токена; `null` — без лимита

Поля ответа: TranscribeJob (5)

Поле	Тип	Описание
`id`обязательное	`string`
`status`обязательное	`string`	`processing` · `ready` · `failed`
`sources`обязательное	`integer[]`
`createdAt`обязательное	`string`
`error`	`string`

Пример ответа

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

Задачи распознавания речи

GET/v1/projects/{id}/transcribe

Области доступа: projects:read
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/transcribe" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/projects/42/transcribe', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/transcribe",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Пример ответа

{
  "ok": true,
  "data": [
    {
      "id": "string",
      "status": "processing",
      "sources": [
        1
      ],
      "createdAt": "2026-10-16T09:30:00Z",
      "error": "string"
    }
  ]
}

Команда ИИ-помощнику

POST/v1/projects/{id}/assistant

Области доступа: montage:run
Лимит: платные операции
Цена: тратит токены

Списывается, только если что-то изменилось. Результат сохраняется.

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `AssistantRequest`

Поле	Тип	Описание
`command`обязательное	`string`	Что поменять, на любом языке≤ 500
`rev`обязательное	`integer`
`confirmCost`	`integer`	Цена, на которую вы согласны. Без неё ответ — `Quote`, ничего не запускается

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/assistant" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"Сделай субтитры крупнее","rev":7}'

const response = await fetch('https://api.slicer.media/v1/projects/42/assistant', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "command": "Сделай субтитры крупнее",
    "rev": 7
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/assistant",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "command": "Сделай субтитры крупнее",
        "rev": 7,
    },
)
body = response.json()

Ответ

Один из вариантов: Quote, AssistantResult

Поля ответа: Quote (8)

Поле	Тип	Описание
`status`обязательное	`"quote"`
`cost`обязательное	`integer`	Цена в токенах; повторите запрос с `confirmCost`, равным ей. У операции по себестоимости (`atCost`) — предельная: спишется фактическая себестоимость, не больше
`free`обязательное	`boolean`	Операция бесплатна (первый ролик, бесплатный повтор)
`estimate`	`number`	Операция по себестоимости: ожидаемая цена в токенах (дробно)
`atCost`	`boolean`	Цена — себестоимость ИИ-сервисов без наценки: списывается фактическая, не больше `cost`
`available`обязательное	`integer`	Сколько токенов доступно сейчас
`enough`обязательное	`boolean`	Токенов хватает
`spendLimitLeft`обязательное	`integer \| null`	Остаток месячного лимита расходов токена; `null` — без лимита

Поля ответа: AssistantResult (6)

Поле	Тип	Описание
`rev`обязательное	`integer`
`summary`обязательное	`string`
`applied`обязательное	`integer`
`charged`обязательное	`integer`	Списано токенов с кошелька (целые)
`costTokens`	`number`	Фактическая себестоимость команды в токенах (дробно); остаток копится у проекта
`durationSec`обязательное	`number`

Пример ответа

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

Перевести субтитры

POST/v1/projects/{id}/translate

Области доступа: montage:run
Лимит: платные операции
Цена: тратит токены

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `TranslateRequest`

Поле	Тип	Описание
`language`обязательное	`string`	`en` · `es` · `pt` · `de` · `fr` · `it` · `pl` · `tr` · `id` · `uk` · `ru`
`rev`обязательное	`integer`
`confirmCost`	`integer`	Цена, на которую вы согласны. Без неё ответ — `Quote`, ничего не запускается

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/translate" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"language":"en","rev":7}'

const response = await fetch('https://api.slicer.media/v1/projects/42/translate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "language": "en",
    "rev": 7
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/translate",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "language": "en",
        "rev": 7,
    },
)
body = response.json()

Ответ

Один из вариантов: Quote, TranslateResult

Поля ответа: Quote (8)

Поле	Тип	Описание
`status`обязательное	`"quote"`
`cost`обязательное	`integer`	Цена в токенах; повторите запрос с `confirmCost`, равным ей. У операции по себестоимости (`atCost`) — предельная: спишется фактическая себестоимость, не больше
`free`обязательное	`boolean`	Операция бесплатна (первый ролик, бесплатный повтор)
`estimate`	`number`	Операция по себестоимости: ожидаемая цена в токенах (дробно)
`atCost`	`boolean`	Цена — себестоимость ИИ-сервисов без наценки: списывается фактическая, не больше `cost`
`available`обязательное	`integer`	Сколько токенов доступно сейчас
`enough`обязательное	`boolean`	Токенов хватает
`spendLimitLeft`обязательное	`integer \| null`	Остаток месячного лимита расходов токена; `null` — без лимита

Поля ответа: TranslateResult (4)

Поле	Тип	Описание
`rev`обязательное	`integer`
`phrases`обязательное	`integer`
`charged`обязательное	`integer`	Списано токенов с кошелька (целые)
`costTokens`	`number`	Фактическая себестоимость перевода в токенах (дробно)

Пример ответа

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

Автобаланс и подбор цвета (бесплатно)

POST/v1/projects/{id}/auto-color

Области доступа: projects:write
Лимит: обычный

Без ИИ: статистика 10 кадров фрагмента → значения «Настроить» (экспозиция, контраст, насыщенность, баланс белого). Результат применяется и сохраняется.

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `AutoColorRequest`

Поле	Тип	Описание
`rev`обязательное	`integer`	Ревизия из GET …/transcript или …/document
`blockId`обязательное	`string`	Id фрагмента: который поправить (`auto`) или образец (`match`)≤ 64
`mode`обязательное	`string`	`auto` — выровнять этот фрагмент; `match` — сделать остальные похожими на него (с его фильтром и LUT)`auto` · `match`

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/auto-color" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rev":7,"blockId":"string","mode":"auto"}'

const response = await fetch('https://api.slicer.media/v1/projects/42/auto-color', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "rev": 7,
    "blockId": "string",
    "mode": "auto"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/auto-color",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "rev": 7,
        "blockId": "string",
        "mode": "auto",
    },
)
body = response.json()

Ответ

Поля ответа: AutoColorResult (5)

Поле	Тип	Описание
`rev`обязательное	`integer`
`mode`обязательное	`string`	`auto` · `match`
`adjust`обязательное	`Record<string, object>`	Новые значения «Настроить» по id фрагмента
`applied`обязательное	`integer`
`durationSec`обязательное	`number`

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "mode": "auto",
    "adjust": {},
    "applied": 1,
    "durationSec": 42.5
  }
}

Сменить стиль

PATCH/v1/projects/{id}/style

Области доступа: projects:write
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `StyleRequest`

Поле	Тип	Описание
`templateId`	`string`
`fontId`	`string`
`colorId`	`string`
`subtitles`	`object`	Вид субтитров; частичная правка сохраняет остальные поля. Новое `design` без `highlight`/`animation`/`words` возвращает их к `auto`
`subtitles.enabled`	`boolean`
`subtitles.design`	`string`	`dynamic` · `karaoke` · `classic` · `minimal` · `pop` · `box` · `word`
`subtitles.size`	`string`	`small` · `medium` · `large`
`subtitles.position`	`string`	`auto` — каждая фраза там, где в кадре свободнее (не на лице, хуке, плашках, титрах)`auto` · `top` · `center` · `bottom`
`subtitles.speakerColors`	`boolean`	Слова каждого говорящего — своим цветом
`subtitles.highlight`	`string`	Слово, которое звучит: цвет, увеличение, плашка, подчёркивание; `auto` — как задумано оформлением`auto` · `none` · `color` · `pop` · `box` · `underline`
`subtitles.animation`	`string`	Появление фразы; `words` — по словам, по мере речи`auto` · `none` · `fade` · `pop` · `slide` · `words`
`subtitles.words`	`string`	Сколько слов на экране сразу`auto` · `one` · `few` · `line` · `phrase`
`subtitles.letterCase`	`string`	Регистр; `auto` — как задумано шрифтом`auto` · `upper` · `normal`
`params`	`object`
`params.soundEffects`	`boolean`
`params.introZoom`	`boolean`

Запрос

curl

JavaScript

Python

curl -X PATCH "https://api.slicer.media/v1/projects/42/style" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"string","fontId":"string"}'

const response = await fetch('https://api.slicer.media/v1/projects/42/style', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "templateId": "string",
    "fontId": "string"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.patch(
    "https://api.slicer.media/v1/projects/42/style",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "templateId": "string",
        "fontId": "string",
    },
)
body = response.json()

Ответ

Поля ответа: Project (26)

Поле	Тип	Описание
`id`обязательное	`integer`
`title`обязательное	`string`
`status`обязательное	`string`	`draft` — проект «Сам в редакторе» до первого экспорта: правьте операциями и экспортируйте`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`обязательное	`string`	`ai` — монтаж ИИ-режиссёром; `manual` — материалы на таймлайне как есть, бесплатно (платны только ИИ-операции)`ai` · `manual`
`stage`обязательное	`string \| null`
`progress`обязательное	`integer`	Прогресс текущего запуска, %
`client`обязательное	`string \| null`	Где создан: web, mobile, api, mcp
`settings`обязательное	`object`	Настройки монтажа (см. MontageSettingsInput)
`brief`обязательное	`string \| null`
`isFree`обязательное	`boolean`
`watermark`обязательное	`boolean`
`tokensCost`обязательное	`integer`
`error`обязательное	`object \| null`
`error.code`обязательное	`string`
`error.message`обязательное	`string`
`durationSec`обязательное	`number \| null`
`versionChoice`обязательное	`integer[] \| null`	Id версий, ждущих выбора; монтаж отдаёт одну версию, поэтому обычно `null`
`result`обязательное	`object \| null`
`result.url`обязательное	`string (uri)`	Скачать с токеном (поддерживается Range)
`result.posterUrl`обязательное	`string (uri) \| null`
`result.container`обязательное	`string`
`result.info`обязательное	`object \| null`
`appUrl`обязательное	`string (uri)`	Проект в веб-приложении Slicer
`sourcesAvailable`обязательное	`boolean`	Исходники хранятся 7 дней после монтажа
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC
`finishedAt`обязательное	`string \| null`

Пример ответа

{
  "ok": true,
  "data": {
    "id": 42,
    "title": "Монтаж за 3 минуты",
    "status": "queued",
    "mode": "ai",
    "stage": "string",
    "progress": 0.5,
    "client": "string",
    "settings": {},
    "brief": "Динамично, с акцентом на главные мысли",
    "isFree": true,
    "watermark": true,
    "tokensCost": 24,
    "error": {
      "code": "string",
      "message": "string"
    },
    "durationSec": 42.5,
    "versionChoice": [
      1
    ],
    "result": {
      "url": "https://example.com/hook",
      "posterUrl": "https://api.slicer.media/v1/…",
      "container": "string",
      "info": {}
    },
    "appUrl": "https://api.slicer.media/v1/…",
    "sourcesAvailable": true,
    "createdAt": "2026-10-16T09:30:00Z",
    "finishedAt": "2026-10-16T09:30:00Z"
  }
}

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

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

Бриф режиссёра для вашего ИИ-ассистента (бесплатно)

POST/v1/projects/{id}/director/brief

Области доступа: projects:write
Лимит: обычный

Материал (речь по id слов, паузы, дубли, пожелания), общие советы и схемы плана и наблюдений по кадрам. Ассистент смотрит кадры через sourceFrames и присылает план вместе с тем, что увидел, в submitDirectorPlan — правила режиссёра Slicer работают там, на сервере. Настройки, если переданы, сохраняются в проекте.

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `DirectorBriefRequest`

Поле	Тип	Описание
`mode`	`string`	Тип ролика`auto` · `talking` · `story` · `product` · `aesthetic`
`pace`	`string`	`calm` · `balanced` · `dynamic`
`effects`	`string`	`off` · `light` · `bold`
`targetDurationSec`	`integer \| null`	Длина ролика, с; null — решает режиссёр (до 90 с)10–180
`hook`	`boolean`	Хук и заголовок в начале
`plaques`	`boolean`
`emoji`	`boolean`
`cameraMotion`	`boolean`	Наезды и движение камеры

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/director/brief" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"auto","pace":"calm"}'

const response = await fetch('https://api.slicer.media/v1/projects/42/director/brief', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mode": "auto",
    "pace": "calm"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/director/brief",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "mode": "auto",
        "pace": "calm",
    },
)
body = response.json()

Ответ

Поля ответа: DirectorBrief (15)

Поле	Тип	Описание
`projectId`обязательное	`integer`
`rev`обязательное	`integer`
`settings`обязательное	`Record<string, object>`
`sources`обязательное	`object[]`
`sources[].index`обязательное	`integer`
`sources[].kind`обязательное	`string`
`sources[].durationSec`обязательное	`number`
`sources[].fileName`обязательное	`string \| null`
`sources[].words`обязательное	`integer`
`speechRecognized`обязательное	`boolean`
`material`обязательное	`string`	Материал: исходники, речь по id слов, паузы, дубли, пожелания
`guide`обязательное	`string[]`	Общие советы (правила режиссёра Slicer работают на сервере при приёме плана)
`planSchema`обязательное	`Record<string, object>`	JSON-схема плана для submitDirectorPlan
`scenesSchema`обязательное	`Record<string, object>`	JSON-схема того, что вы увидели в кадрах
`next`обязательное	`string[]`

Пример ответа

{
  "ok": true,
  "data": {
    "projectId": 42,
    "rev": 7,
    "settings": {},
    "sources": [
      {
        "index": 1,
        "kind": "string",
        "durationSec": 42.5,
        "fileName": "interview.mp4",
        "words": 1
      }
    ],
    "speechRecognized": true,
    "material": "string",
    "guide": [
      "string"
    ],
    "planSchema": {},
    "scenesSchema": {},
    "next": [
      "string"
    ]
  }
}

Кадры исходника (бесплатно)

GET/v1/projects/{id}/sources/{index}/frames

Области доступа: projects:read
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1
`index`обязательное	`integer`

Параметры запроса

Поле	Тип	Описание
`times`	`string`
`from`	`number`
`to`	`number`
`count`	`integer`	1–16

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/sources/1/frames" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/projects/42/sources/1/frames', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/sources/1/frames",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: SourceFrames (6)

Поле	Тип	Описание
`sourceIndex`обязательное	`integer`
`durationSec`обязательное	`number`
`frames`обязательное	`object[]`
`frames[].time`обязательное	`number`
`frames[].mimeType`обязательное	`"image/jpeg"`
`frames[].data`обязательное	`string`	JPEG, base64, 512 px по большей стороне

Пример ответа

{
  "ok": true,
  "data": {
    "sourceIndex": 1,
    "durationSec": 42.5,
    "frames": [
      {
        "time": 1.5,
        "mimeType": "image/jpeg",
        "data": "string"
      }
    ]
  }
}

Применить план режиссёра (бесплатно)

POST/v1/projects/{id}/director/plan

Области доступа: projects:write
Лимит: обычный

К плану на сервере применяются правила режиссёра Slicer (границы слов, дубли, видеоряд по вашим наблюдениям, сдержанность, длительность): план становится документом ролика — новая ревизия, видна в редакторе, — в ответе исправления и замечания. Медиа-карточки по описанию не принимаются (их картинка — платная генерация).

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `DirectorPlanRequest`

Поле	Тип	Описание
`rev`обязательное	`integer`	rev из directorBrief или текста ролика
`plan`обязательное	`Record<string, object>`	План в схеме DirectorBrief.planSchema
`scenes`	`Record<string, object>[]`	Что вы увидели в кадрах, в схеме DirectorBrief.scenesSchema0–400

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/director/plan" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rev":7,"plan":{}}'

const response = await fetch('https://api.slicer.media/v1/projects/42/director/plan', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "rev": 7,
    "plan": {}
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/director/plan",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "rev": 7,
        "plan": {},
    },
)
body = response.json()

Ответ

Поля ответа: DirectorPlanResult (10)

Поле	Тип	Описание
`rev`обязательное	`integer`
`durationSec`обязательное	`number`
`planSegments`обязательное	`integer`
`fragments`обязательное	`integer`
`fixes`обязательное	`string[]`	Что Slicer поправил по своим правилам режиссёра
`issues`обязательное	`object[]`	Что поправить и прислать план снова
`issues[].code`обязательное	`string`
`issues[].segment`	`integer`
`issues[].message`обязательное	`string`
`video`обязательное	`string`	Получившийся ролик текстом (фрагменты, слова, элементы) — сверьте с замыслом

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "durationSec": 42.5,
    "planSegments": 1,
    "fragments": 1,
    "fixes": [
      "string"
    ],
    "issues": [
      {
        "code": "string",
        "segment": 1,
        "message": "string"
      }
    ],
    "video": "string"
  }
}

Документ монтажа

GET/v1/projects/{id}/document

Области доступа: projects:read
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/document" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/projects/42/document', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/document",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: DocumentState (3)

Поле	Тип	Описание
`rev`обязательное	`integer`
`durationSec`обязательное	`number`
`document`обязательное	`object`	Документ монтажа (EditDocument v1). Внутри v1 поля только добавляются

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "durationSec": 42.5,
    "document": {}
  }
}

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

PUT/v1/projects/{id}/document

Области доступа: projects:write
Лимит: обычный

Параметры пути

Поле	Тип	Описание
`id`обязательное	`integer`	≥ 1

Тело запроса `PutDocumentRequest`

Поле	Тип	Описание
`rev`обязательное	`integer`
`document`обязательное	`object`

Запрос

curl

JavaScript

Python

curl -X PUT "https://api.slicer.media/v1/projects/42/document" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rev":7,"document":{}}'

const response = await fetch('https://api.slicer.media/v1/projects/42/document', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "rev": 7,
    "document": {}
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.put(
    "https://api.slicer.media/v1/projects/42/document",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "rev": 7,
        "document": {},
    },
)
body = response.json()

Ответ

Поля ответа: DocumentState (3)

Поле	Тип	Описание
`rev`обязательное	`integer`
`durationSec`обязательное	`number`
`document`обязательное	`object`	Документ монтажа (EditDocument v1). Внутри v1 поля только добавляются

Пример ответа

{
  "ok": true,
  "data": {
    "rev": 7,
    "durationSec": 42.5,
    "document": {}
  }
}

Схемы

Transcript

Поле	Тип	Описание
`rev`обязательное	`integer`	Ревизия документа: передайте её в правки
`durationSec`обязательное	`number`
`text`обязательное	`string`	Ролик текстом для LLM: фрагменты со словами `w<id>`, вырезанное — в [скобках], графика
`blocks`обязательное	`object[]`
`blocks[].id`обязательное	`string`
`blocks[].position`обязательное	`integer`
`blocks[].sourceIndex`обязательное	`integer`
`blocks[].kind`обязательное	`string`	`words` · `range`
`blocks[].words`обязательное	`object[]`
`blocks[].words[].id`обязательное	`integer`
`blocks[].words[].text`обязательное	`string`
`blocks[].words[].cut`обязательное	`boolean`
`blocks[].words[].accent`обязательное	`boolean`
`elements`обязательное	`object`
`elements.hook`обязательное	`string \| null`
`elements.plaques`обязательное	`object[]`
`elements.plaques[].id`обязательное	`string`
`elements.plaques[].kind`обязательное	`string`
`elements.plaques[].title`обязательное	`string`
`elements.plaques[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.plaques[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.plaques[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.plaques[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.plaques[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.plaques[].anchor.blockId`обязательное	`string`
`elements.plaques[].anchor.at`обязательное	`number`
`elements.plaques[].anchor.duration`обязательное	`number`
`elements.cards`обязательное	`object[]`
`elements.cards[].id`обязательное	`string`
`elements.cards[].caption`обязательное	`string \| null`
`elements.cards[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.cards[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.cards[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.cards[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.cards[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.cards[].anchor.blockId`обязательное	`string`
`elements.cards[].anchor.at`обязательное	`number`
`elements.cards[].anchor.duration`обязательное	`number`
`elements.emoji`обязательное	`object[]`
`elements.emoji[].id`обязательное	`string`
`elements.emoji[].emoji`обязательное	`string`
`elements.emoji[].wordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.emoji[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.emoji[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.emoji[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.emoji[].anchor.blockId`обязательное	`string`
`elements.emoji[].anchor.at`обязательное	`number`
`elements.emoji[].anchor.duration`обязательное	`number`
`elements.zooms`обязательное	`object[]`
`elements.zooms[].id`обязательное	`string`
`elements.zooms[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.zooms[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.zooms[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.zooms[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.zooms[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.zooms[].anchor.blockId`обязательное	`string`
`elements.zooms[].anchor.at`обязательное	`number`
`elements.zooms[].anchor.duration`обязательное	`number`
`elements.titles`обязательное	`object[]`	Свободные текстовые слои (титры)
`elements.titles[].id`обязательное	`string`
`elements.titles[].text`обязательное	`string`
`elements.titles[].font`обязательное	`string`
`elements.titles[].size`обязательное	`number`
`elements.titles[].color`обязательное	`string`
`elements.titles[].background`обязательное	`string`	`none` · `box` · `pill`
`elements.titles[].backgroundColor`	`string`
`elements.titles[].outline`	`boolean`
`elements.titles[].shadow`	`boolean`
`elements.titles[].align`обязательное	`string`	`left` · `center` · `right`
`elements.titles[].x`обязательное	`number`
`elements.titles[].y`обязательное	`number`
`elements.titles[].animIn`	`string`	`fade` · `slide` · `pop` · `typewriter`
`elements.titles[].animOut`	`string`	`fade` · `slide` · `pop`
`elements.titles[].fromWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.titles[].toWordId`обязательное	`integer \| null`	Id слова; `null` — элемент стоит по времени (`anchor`)
`elements.titles[].start`	`number`	Где элемент начинается в ролике, с; нет — не показывается (его слова вырезаны)
`elements.titles[].end`	`number`	Где элемент заканчивается в ролике, с
`elements.titles[].anchor`	`object`	Привязка ко времени: фрагмент, секунда его исходника и длительность в ролике, с
`elements.titles[].anchor.blockId`обязательное	`string`
`elements.titles[].anchor.at`обязательное	`number`
`elements.titles[].anchor.duration`обязательное	`number`
`elements.markers`обязательное	`object[]`	Маркеры автора на таймлайне (в ролик не попадают); отрезанные не показываются
`elements.markers[].id`обязательное	`string`
`elements.markers[].time`обязательное	`number`
`elements.markers[].label`обязательное	`string \| null`
`elements.markers[].color`обязательное	`string`	`cyan` · `yellow` · `red` · `green` · `violet`
`elements.sounds`обязательное	`object[]`	Звуковые эффекты, которые поставил автор; отрезанные не показываются
`elements.sounds[].id`обязательное	`string`
`elements.sounds[].kind`обязательное	`string`	`whoosh` · `pop` · `ding` · `click` · `swipe` · `rise` · `boom` · `chime`
`elements.sounds[].time`обязательное	`number`

EditOperation

Поле	Тип	Описание

EditsResult

Поле	Тип	Описание
`rev`обязательное	`integer`
`applied`обязательное	`integer`
`skipped`обязательное	`object[]`
`skipped[].index`обязательное	`integer`
`skipped[].op`обязательное	`string`
`skipped[].reason`обязательное	`string`
`durationSec`обязательное	`number`

TranscribeRequest

Поле	Тип	Описание
`sources`	`integer[]`	Номера исходников (по умолчанию — все со звуком, где речь ещё не распознана)1–40
`language`	`string`	Язык речи: auto или двухбуквенный код
`confirmCost`	`integer`	Цена, на которую вы согласны. Без неё ответ — `Quote`, ничего не запускается

TranscribeJob

Поле	Тип	Описание
`id`обязательное	`string`
`status`обязательное	`string`	`processing` · `ready` · `failed`
`sources`обязательное	`integer[]`
`createdAt`обязательное	`string`
`error`	`string`

AssistantResult

Поле	Тип	Описание
`rev`обязательное	`integer`
`summary`обязательное	`string`
`applied`обязательное	`integer`
`charged`обязательное	`integer`	Списано токенов с кошелька (целые)
`costTokens`	`number`	Фактическая себестоимость команды в токенах (дробно); остаток копится у проекта
`durationSec`обязательное	`number`

TranslateResult

Поле	Тип	Описание
`rev`обязательное	`integer`
`phrases`обязательное	`integer`
`charged`обязательное	`integer`	Списано токенов с кошелька (целые)
`costTokens`	`number`	Фактическая себестоимость перевода в токенах (дробно)

StyleRequest

Поле	Тип	Описание
`templateId`	`string`
`fontId`	`string`
`colorId`	`string`
`subtitles`	`object`	Вид субтитров; частичная правка сохраняет остальные поля. Новое `design` без `highlight`/`animation`/`words` возвращает их к `auto`
`subtitles.enabled`	`boolean`
`subtitles.design`	`string`	`dynamic` · `karaoke` · `classic` · `minimal` · `pop` · `box` · `word`
`subtitles.size`	`string`	`small` · `medium` · `large`
`subtitles.position`	`string`	`auto` — каждая фраза там, где в кадре свободнее (не на лице, хуке, плашках, титрах)`auto` · `top` · `center` · `bottom`
`subtitles.speakerColors`	`boolean`	Слова каждого говорящего — своим цветом
`subtitles.highlight`	`string`	Слово, которое звучит: цвет, увеличение, плашка, подчёркивание; `auto` — как задумано оформлением`auto` · `none` · `color` · `pop` · `box` · `underline`
`subtitles.animation`	`string`	Появление фразы; `words` — по словам, по мере речи`auto` · `none` · `fade` · `pop` · `slide` · `words`
`subtitles.words`	`string`	Сколько слов на экране сразу`auto` · `one` · `few` · `line` · `phrase`
`subtitles.letterCase`	`string`	Регистр; `auto` — как задумано шрифтом`auto` · `upper` · `normal`
`params`	`object`
`params.soundEffects`	`boolean`
`params.introZoom`	`boolean`

DirectorBriefRequest

Поле	Тип	Описание
`mode`	`string`	Тип ролика`auto` · `talking` · `story` · `product` · `aesthetic`
`pace`	`string`	`calm` · `balanced` · `dynamic`
`effects`	`string`	`off` · `light` · `bold`
`targetDurationSec`	`integer \| null`	Длина ролика, с; null — решает режиссёр (до 90 с)10–180
`hook`	`boolean`	Хук и заголовок в начале
`plaques`	`boolean`
`emoji`	`boolean`
`cameraMotion`	`boolean`	Наезды и движение камеры

DirectorBrief

Поле	Тип	Описание
`projectId`обязательное	`integer`
`rev`обязательное	`integer`
`settings`обязательное	`Record<string, object>`
`sources`обязательное	`object[]`
`sources[].index`обязательное	`integer`
`sources[].kind`обязательное	`string`
`sources[].durationSec`обязательное	`number`
`sources[].fileName`обязательное	`string \| null`
`sources[].words`обязательное	`integer`
`speechRecognized`обязательное	`boolean`
`material`обязательное	`string`	Материал: исходники, речь по id слов, паузы, дубли, пожелания
`guide`обязательное	`string[]`	Общие советы (правила режиссёра Slicer работают на сервере при приёме плана)
`planSchema`обязательное	`Record<string, object>`	JSON-схема плана для submitDirectorPlan
`scenesSchema`обязательное	`Record<string, object>`	JSON-схема того, что вы увидели в кадрах
`next`обязательное	`string[]`

SourceFrames

Поле	Тип	Описание
`sourceIndex`обязательное	`integer`
`durationSec`обязательное	`number`
`frames`обязательное	`object[]`
`frames[].time`обязательное	`number`
`frames[].mimeType`обязательное	`"image/jpeg"`
`frames[].data`обязательное	`string`	JPEG, base64, 512 px по большей стороне

DirectorPlanRequest

Поле	Тип	Описание
`rev`обязательное	`integer`	rev из directorBrief или текста ролика
`plan`обязательное	`Record<string, object>`	План в схеме DirectorBrief.planSchema
`scenes`	`Record<string, object>[]`	Что вы увидели в кадрах, в схеме DirectorBrief.scenesSchema0–400

DirectorPlanResult

Поле	Тип	Описание
`rev`обязательное	`integer`
`durationSec`обязательное	`number`
`planSegments`обязательное	`integer`
`fragments`обязательное	`integer`
`fixes`обязательное	`string[]`	Что Slicer поправил по своим правилам режиссёра
`issues`обязательное	`object[]`	Что поправить и прислать план снова
`issues[].code`обязательное	`string`
`issues[].segment`	`integer`
`issues[].message`обязательное	`string`
`video`обязательное	`string`	Получившийся ролик текстом (фрагменты, слова, элементы) — сверьте с замыслом

DocumentState

Поле	Тип	Описание
`rev`обязательное	`integer`
`durationSec`обязательное	`number`
`document`обязательное	`object`	Документ монтажа (EditDocument v1). Внутри v1 поля только добавляются

Ролик текстом с id слов#

Параметры пути

Запрос

Ответ

Применить правки#

Параметры пути

Тело запроса EditsRequest

Запрос

Ответ

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

Параметры пути

Тело запроса TranscribeRequest

Запрос

Ответ

Задачи распознавания речи#

Параметры пути

Запрос

Ответ

Команда ИИ-помощнику#

Параметры пути

Тело запроса AssistantRequest

Запрос

Ответ

Перевести субтитры#

Параметры пути

Тело запроса TranslateRequest

Запрос

Ответ

Автобаланс и подбор цвета (бесплатно)#

Параметры пути

Тело запроса AutoColorRequest

Запрос

Ответ

Сменить стиль#

Параметры пути

Тело запроса StyleRequest

Запрос

Ответ

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

Бриф режиссёра для вашего ИИ-ассистента (бесплатно)#

Параметры пути

Тело запроса DirectorBriefRequest

Запрос

Ответ

Кадры исходника (бесплатно)#

Параметры пути

Параметры запроса

Запрос

Ответ

Применить план режиссёра (бесплатно)#

Параметры пути

Тело запроса DirectorPlanRequest

Запрос

Ответ

Документ монтажа#

Документ монтажа#

Параметры пути

Запрос

Ответ

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

Параметры пути

Тело запроса PutDocumentRequest

Запрос

Ответ

Схемы#

Ролик текстом с id слов

Применить правки

Тело запроса `EditsRequest`

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

Тело запроса `TranscribeRequest`

Задачи распознавания речи

Команда ИИ-помощнику

Тело запроса `AssistantRequest`

Перевести субтитры

Тело запроса `TranslateRequest`

Автобаланс и подбор цвета (бесплатно)

Тело запроса `AutoColorRequest`

Сменить стиль

Тело запроса `StyleRequest`

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

Бриф режиссёра для вашего ИИ-ассистента (бесплатно)

Тело запроса `DirectorBriefRequest`

Кадры исходника (бесплатно)

Применить план режиссёра (бесплатно)

Тело запроса `DirectorPlanRequest`

Документ монтажа

Документ монтажа

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

Тело запроса `PutDocumentRequest`

Схемы