# Инструменты MCP
> Все инструменты MCP-сервера Slicer по группам — аккаунт, загрузки, проекты, правки, субтитры из речи, экспорт, документация — с ценой и примерами просьб.
Источник: https://docs.slicer.media/mcp/tools/
Инструменты — действия, которые ассистент может выполнить в Slicer. Вам не нужно вызывать их самому: опишите задачу словами, и ассистент выберет нужные. Эта страница помогает понять, что он умеет и о чём его можно просить.
Главный путь бесплатный: ассистент создаёт проект, как **Сам в редакторе** в приложении, и монтирует его сам — правками, стилем и экспортом. Платные только ИИ-функции Slicer — они собраны ниже, и каждая сначала называет цену.
Инструменты построены на тех же контрактах, что [REST API](https://docs.slicer.media/api/), и ведут себя так же: те же проверки, цены и ограничения. Результаты приходят и текстом для модели, и структурированными данными. Описания инструментов — на английском (их читает модель), ответы — на языке вашего аккаунта.
| Инструмент | Что делает | Пример промпта |
| --- | --- | --- |
| `get_account` | **Аккаунт и баланс** — Баланс токенов, доступен ли бесплатный первый ролик, цена монтажа и месячный лимит расходов подключения.
`account:read` | «Сколько у меня осталось токенов в Slicer?» |
| `list_styles` | **Стили и настройки** — Каталог шаблонов, шрифтов и акцентов субтитров, оформления, параметров монтажа, режиссуры, длительностей, лимитов материалов и цен. Id отсюда — для create\_project, remount\_project и set\_style.любой токен | «Какие стили субтитров есть в Slicer?» |
| `estimate_cost` | **Цена операции** — Цена в токенах монтажа, пересборки, повтора, команды помощника или перевода и хватит ли баланса и лимита.любой токен | «Сколько стоит новый монтаж?» |
| `create_upload_link` | **Загрузить файл** — Создаёт загрузку и возвращает одноразовую ссылку (1 час) для PUT всего файла без токена, например `curl -T video.mp4 ""`. Для агентов, которые могут выполнять команды рядом с файлами пользователя. После загрузки — get\_upload до статуса ready.
`projects:write` | «Загрузи ~/Videos/interview.mp4 в Slicer» |
| `import_from_url` | **Загрузить файл по ссылке** — Скачивает файл по публичной https-ссылке (прямая ссылка на файл) в фоне. Опрашивайте get\_upload до статуса ready или failed.
`projects:write` | «Возьми видео по этой ссылке и сделай рилс» |
| `get_upload` | **Статус загрузки** — Статус загрузки или импорта: uploading, processing, ready или failed (с причиной), вид и длительность.
`projects:read` | «Видео уже загрузилось?» |
| `create_project` | **Создать ролик** — Создаёт проект из готовых загрузок. По умолчанию — «manual», как «Сам в редакторе» в приложении: бесплатно, без confirmCost, материалы на таймлайне по порядку, черновик правите вы (edit\_project, set\_style) и рендерите export\_video (бесплатно); субтитры речи — transcribe\_speech (платно). Режим «ai» — только если пользователь просит ИИ-режиссёра Slicer: две версии, сначала цена без confirmCost, после согласия — с confirmCost; первый ролик бесплатный.
`projects:write`
· бесплатно по умолчанию (manual); ИИ-монтаж (ai) — цена монтажа, первый ролик бесплатно, подтверждается confirmCost | «Собери динамичный рилс из этих двух роликов в стиле Bold» |
| `list_projects` | **Список проектов** — Проекты, сначала новые, со статусом и прогрессом.
`projects:read` | «Покажи мои последние ролики в Slicer» |
| `get_project` | **Статус проекта** — Статус, этапы, версии, результат и appUrl. waitSeconds (≤ 50) — подождать изменения статуса или прогресса.
`projects:read` | «Ролик готов?» |
| `choose_version` | **Выбрать версию** — Делает версию текущей по id: любую из get\_project.versions, файл которой хранится (hasFile), — например, ролик до пересборки. Монтаж отдаёт одну версию; прежний ролик остаётся в истории.
`projects:write` | «Верни прежнюю версию» |
| `remount_project` | **Пересобрать с новыми параметрами** — Заново запускает ИИ-монтаж с новыми настройками или пожеланиями; ручные правки сбрасываются. Платно, с confirmCost.
`montage:run`
· цена монтажа, подтверждается confirmCost | «Пересобери спокойнее, без эффектов» |
| `retry_project` | **Повторить неудачный запуск** — Повторяет неудачный или остановленный запуск с первого незавершённого этапа. Бесплатный запуск — бесплатно.
`montage:run`
· как у неудавшегося запуска, подтверждается confirmCost | «Попробуй смонтировать ещё раз» |
| `cancel_project` | **Остановить запуск** — Останавливает монтаж или экспорт; резерв токенов возвращается. Экспорт оставляет прежний ролик.
`projects:write` | «Останови текущий монтаж» |
| `rename_project` | **Переименовать проект** — Меняет название проекта.
`projects:write` | «Назови его «Утренняя рутина»» |
| `delete_project` | **Удалить проект** — Удаляет проект, ролик и материалы навсегда. Сначала спросите подтверждение.
`projects:write` | «Удали тестовый проект» |
| `get_director_brief` | **Бриф режиссёра (свой режиссёр)** — Бесплатно. Чтобы вы монтировали со Slicer: материал (речь по id слов, паузы, дубли, пожелания), исходники, общие советы и схемы плана и наблюдений. Кадры — get\_frames; план и наблюдения — submit\_director\_plan, правила режиссёра Slicer работают там. Настройки, если переданы, сохраняются в проекте.
`projects:write` | «Смонтируй этот ролик сам, как режиссёр Slicer» |
| `get_frames` | **Посмотреть кадры** — Бесплатно. Кадры исходника картинками (до 16 за вызов, 512 px): в заданные секунды или равномерно по отрезку. Сначала по несколько кадров, затем подробнее там, где действие.
`projects:read` | «Покажи, что происходит во втором ролике» |
| `submit_director_plan` | **Применить свой план режиссёра** — Бесплатно. План (planSchema) становится роликом: Slicer применяет свои правила режиссёра на сервере и сохраняет новую ревизию. В ответе — исправления, замечания (поправьте и пришлите снова) и ролик текстом; дальше edit\_project и export\_video.
`projects:write` | «Вот план — собери ролик» |
| `get_transcript` | **Ролик текстом** — Готовый ролик текстом: фрагменты с id слов, вырезанное — в \[скобках\], акценты — \*, неиспользованная речь, графика с id; rev для edit\_project.
`projects:read` | «Что говорится в ролике?» |
| `edit_project` | **Править ролик** — Применяет операции правки к готовому ролику — бесплатно, те же операции, что в редакторе. Сначала get\_transcript; id — только оттуда.
`projects:write` | «Вырежи второе предложение и добавь наезд на «результаты»» |
| `auto_color` | **Автобаланс цвета** — Выравнивает цвет фрагмента без ИИ и бесплатно (режим «auto») или делает остальные фрагменты похожими на него (режим «match», с его фильтром и LUT). Результат сохраняется.
`projects:write` | «Сделай цвет всех фрагментов как у первого» |
| `ask_assistant` | **Команда ИИ-помощнику** — Собственный ИИ-помощник Slicer правит ролик по команде словами; списывается, только если что-то изменилось. Если можете сами — edit\_project бесплатно.
`montage:run`
· по себестоимости ИИ без наценки: в цене — ожидаемая (estimate) и предельная (cost); списывается фактическая, только если что-то изменилось | «Сделай динамичнее и сократи до 30 секунд» |
| `transcribe_speech` | **Субтитры из речи** — Распознаёт речь исходников проекта — после этого субтитры идут за речью (у ручного проекта до этого субтитров нет). В фоне: ход — get\_transcribe\_jobs, слова — get\_transcript. Платно, с confirmCost.
`montage:run`
· по себестоимости ИИ за минуту звука без наценки: в цене — ожидаемая (estimate) и предельная (cost) | «Добавь субтитры к интервью» |
| `get_transcribe_jobs` | **Ход распознавания речи** — Задачи распознавания речи проекта: идёт, готово или не получилось (тогда токены возвращаются).
`projects:read` | «Субтитры уже готовы?» |
| `translate_captions` | **Перевести субтитры** — Переводит субтитры, хук, плашки и подписи карточек; результат сохраняется. Платно, с confirmCost.
`montage:run`
· по себестоимости ИИ без наценки: в цене — ожидаемая (estimate) и предельная (cost); списывается фактическая, только если перевод получился | «Переведи субтитры на испанский» |
| `set_style` | **Сменить стиль** — Меняет шаблон, шрифт, акцент, оформление и положение субтитров, выделение слова, появление фразы, число слов на экране и регистр — бесплатно; в файле — после export\_video.
`projects:write` | «Сделай, чтобы слово, которое звучит, выпрыгивало в субтитрах» |
| `export_video` | **Экспорт и публикация** — Рендерит ролик по текущим правкам (бесплатно) и при желании публикует после рендера в YouTube, Instagram или VK (нужна область publish; TikTok — только из приложения).
`projects:write` | «Экспортируй в 4K и опубликуй на YouTube по ссылке» |
| `list_social_accounts` | **Подключённые соцсети** — Соцсети, подключённые в приложении Slicer; их id — для export\_video → publish.
`publish` | «Куда я могу опубликовать?» |
| `search_docs` | **Поиск по документации** — Ищет по docs.slicer.media и возвращает подходящие страницы; прочитать — read\_doc.любой токен | «Как добавить музыку в ролик в Slicer?» |
| `read_doc` | **Прочитать страницу документации** — Возвращает страницу docs.slicer.media в Markdown по пути (например, /guide/editor/timeline/).любой токен | «Прочитай страницу о горячих клавишах Slicer» |
Пометки у инструментов подсказывают клиенту, как с ними обращаться: «только чтение» ничего не меняет, «необратимое» — удаление, остановка и пересборка; перед такими вызовами многие клиенты переспрашивают вас.
## Аккаунт и каталог
Баланс, цены, бесплатный первый ролик, стили и настройки монтажа. Ассистент обычно вызывает их в начале разговора, чтобы предложить подходящий стиль и знать бюджет. `estimate_cost` называет цену платной функции заранее — в том числе субтитров из речи для проекта (`kind: "transcribe"` с `projectId`).
### Аккаунт и баланс
`tool get_account`
- **Области доступа:** `account:read`
- **MCP:** только чтение
Баланс токенов, доступен ли бесплатный первый ролик, цена монтажа и месячный лимит расходов подключения.
#### Параметры
Без параметров.
#### Пример промпта
> «Сколько у меня осталось токенов в Slicer?»
### Стили и настройки
`tool list_styles`
- **Области доступа:** любой токен
- **MCP:** только чтение · можно повторять
Каталог шаблонов, шрифтов и акцентов субтитров, оформления, параметров монтажа, режиссуры, длительностей, лимитов материалов и цен. Id отсюда — для create\_project, remount\_project и set\_style.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `language` | `string` | Language of titles; default — the account language — `ru` · `en` |
#### Пример промпта
> «Какие стили субтитров есть в Slicer?»
### Цена операции
`tool estimate_cost`
- **Области доступа:** любой токен
- **MCP:** только чтение
Цена в токенах монтажа, пересборки, повтора, команды помощника или перевода и хватит ли баланса и лимита.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `kind` _(обязательное)_ | `string` | — `montage` · `remount` · `retry` · `assistant` · `translate` · `transcribe` |
| `projectId` | `integer` | Required for retry and transcribe — ≥ 1 |
#### Пример промпта
> «Сколько стоит новый монтаж?»
Что можно попросить:
- «Сколько у меня токенов?»
- «Какие стили субтитров есть в Slicer? Покажи с описаниями.»
- «Как в Slicer можно выделить слово, которое звучит?»
## Загрузки
Материалы попадают в Slicer двумя путями. `create_upload_link` создаёт загрузку и одноразовую ссылку: ассистент, который умеет выполнять команды на вашем компьютере, сам отправляет по ней локальный файл командой `curl -T`. Ассистенту без доступа к файлам удобнее `import_from_url` — Slicer скачает файл по публичной `https`\-ссылке.
### Загрузить файл
`tool create_upload_link`
- **Области доступа:** `projects:write`
Создаёт загрузку и возвращает одноразовую ссылку (1 час) для PUT всего файла без токена, например `curl -T video.mp4 ""`. Для агентов, которые могут выполнять команды рядом с файлами пользователя. После загрузки — get\_upload до статуса ready.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `fileName` _(обязательное)_ | `string` | File name with extension — ≤ 255 |
| `size` _(обязательное)_ | `integer` | Exact file size in bytes — ≥ 1 |
| `purpose` | `string` | `source` (default) — montage material — `source` · `media` · `music` |
#### Пример промпта
> «Загрузи ~/Videos/interview.mp4 в Slicer»
### Загрузить файл по ссылке
`tool import_from_url`
- **Области доступа:** `projects:write`
- **MCP:** обращается к внешним адресам
Скачивает файл по публичной https-ссылке (прямая ссылка на файл) в фоне. Опрашивайте get\_upload до статуса ready или failed.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `url` _(обязательное)_ | `string (uri)` | Public https URL of the file |
| `fileName` | `string` | Name with extension if the URL has none — ≤ 255 |
| `purpose` | `string` | — `source` · `media` · `music` |
#### Пример промпта
> «Возьми видео по этой ссылке и сделай рилс»
### Статус загрузки
`tool get_upload`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Статус загрузки или импорта: uploading, processing, ready или failed (с причиной), вид и длительность.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `uploadId` _(обязательное)_ | `string (uuid)` | |
#### Пример промпта
> «Видео уже загрузилось?»
Что можно попросить:
- «Загрузи в Slicer все видео из папки `~/Movies/event`.»
- «Возьми видео по ссылке [https://media.example.com/clips/product-demo.mp4.»](https://media.example.com/clips/product-demo.mp4.%C2%BB)
## Проекты
`create_project` по умолчанию создаёт бесплатный [проект без ИИ-режиссёра](https://docs.slicer.media/api/montage/#manual) — как **Сам в редакторе** в приложении: без цены и подтверждения, материалы ложатся на таймлайн по порядку, через несколько секунд проект становится черновиком (`draft`). Дальше ассистент собирает ролик правками и рендерит его `export_video`. `format` задаёт формат кадра: `9:16`, `4:5`, `1:1` или `16:9`.
С `mode: "ai"` ролик монтирует ИИ-режиссёр Slicer и сам проверяет готовый результат — это платно, и ассистент делает так, только если вы сами попросите ([пример](https://docs.slicer.media/mcp/examples/#ai-director)). Такой вызов без `confirmCost` лишь называет цену; пересборка `remount_project` и повтор `retry_project` — тоже платные, с той же проверкой цены.
`get_project` умеет ждать: с `waitSeconds` (до 50 секунд) он вернётся, как только в проекте что-то изменится, — ассистенту не нужно часто опрашивать статус.
### Создать ролик
`tool create_project`
- **Области доступа:** `projects:write`
- **Цена:** бесплатно по умолчанию (manual); ИИ-монтаж (ai) — цена монтажа, первый ролик бесплатно, подтверждается confirmCost
Создаёт проект из готовых загрузок. По умолчанию — «manual», как «Сам в редакторе» в приложении: бесплатно, без confirmCost, материалы на таймлайне по порядку, черновик правите вы (edit\_project, set\_style) и рендерите export\_video (бесплатно); субтитры речи — transcribe\_speech (платно). Режим «ai» — только если пользователь просит ИИ-режиссёра Slicer: две версии, сначала цена без confirmCost, после согласия — с confirmCost; первый ролик бесплатный.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `uploadIds` _(обязательное)_ | `string (uuid)[]` | Ready uploads with purpose source, in material order — 1–20 |
| `mode` | `string` | manual (default) — free draft you edit yourself, like «Edit it myself» in the app; ai — Slicer’s AI director montage, paid — `manual` · `ai` |
| `format` | `string` | Frame format of a manual project (default 9:16) — `9:16` · `4:5` · `1:1` · `16:9` |
| `settings` | `object` | Любая часть настроек монтажа; недостающее — по умолчанию, неизвестные id — по умолчанию |
| `settings.templateId` | `string` | Шаблон: `bold`, `clean`, `pop` |
| `settings.fontId` | `string` | Шрифт субтитров: punch, poster, block, wide, editorial, rounded, script, mono |
| `settings.colorId` | `string` | Акцент: amber, azure, lime, crimson, fuchsia, mint, violet, white |
| `settings.subtitles` | `object` | Вид субтитров; частичная правка сохраняет остальные поля. Новое `design` без `highlight`/`animation`/`words` возвращает их к `auto` |
| `settings.subtitles.enabled` | `boolean` | |
| `settings.subtitles.design` | `string` | — `dynamic` · `karaoke` · `classic` · `minimal` · `pop` · `box` · `word` |
| `settings.subtitles.size` | `string` | — `small` · `medium` · `large` |
| `settings.subtitles.position` | `string` | `auto` — каждая фраза там, где в кадре свободнее (не на лице, хуке, плашках, титрах) — `auto` · `top` · `center` · `bottom` |
| `settings.subtitles.speakerColors` | `boolean` | Слова каждого говорящего — своим цветом |
| `settings.subtitles.highlight` | `string` | Слово, которое звучит: цвет, увеличение, плашка, подчёркивание; `auto` — как задумано оформлением — `auto` · `none` · `color` · `pop` · `box` · `underline` |
| `settings.subtitles.animation` | `string` | Появление фразы; `words` — по словам, по мере речи — `auto` · `none` · `fade` · `pop` · `slide` · `words` |
| `settings.subtitles.words` | `string` | Сколько слов на экране сразу — `auto` · `one` · `few` · `line` · `phrase` |
| `settings.subtitles.letterCase` | `string` | Регистр; `auto` — как задумано шрифтом — `auto` · `upper` · `normal` |
| `settings.params` | `object` | Параметры монтажа, см. `GET /v1/styles` → `params` |
| `settings.params.emoji` | `boolean` | |
| `settings.params.soundEffects` | `boolean` | |
| `settings.params.mediaCards` | `boolean` | |
| `settings.params.plaques` | `boolean` | |
| `settings.params.cameraMotion` | `boolean` | |
| `settings.params.introZoom` | `boolean` | |
| `settings.params.hook` | `boolean` | |
| `settings.smartCut` | `boolean` | Умная нарезка: убрать паузы и повторы |
| `settings.targetDurationSec` | `15 \| 30 \| 60 \| 90 \| null` | Длительность; `null` — решает ИИ (до 90 с) |
| `settings.language` | `string` | — `auto` · `ru` · `en` |
| `settings.direction` | `object` | |
| `settings.direction.mode` | `string` | — `auto` · `talking` · `story` · `product` · `aesthetic` |
| `settings.direction.pace` | `string` | — `calm` · `balanced` · `dynamic` |
| `settings.direction.effects` | `string` | — `off` · `light` · `bold` |
| `settings.direction.narration` | `boolean` | Закадровый голос ИИ |
| `settings.direction.voice` | `string` | — `warm` · `soft` · `confident` · `deep` |
| `title` | `string` | — ≤ 120 |
| `brief` | `string` | Wishes for the AI director, in the user’s words — ≤ 600 |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Собери динамичный рилс из этих двух роликов в стиле Bold»
### Список проектов
`tool list_projects`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Проекты, сначала новые, со статусом и прогрессом.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `status` | `string` | — `all` · `ready` · `active` · `failed` · `draft` |
| `q` | `string` | Search by title — ≤ 100 |
| `limit` | `integer` | — 1–100 |
| `cursor` | `string` | — ≤ 200 |
#### Пример промпта
> «Покажи мои последние ролики в Slicer»
### Статус проекта
`tool get_project`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Статус, этапы, версии, результат и appUrl. waitSeconds (≤ 50) — подождать изменения статуса или прогресса.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `waitSeconds` | `integer` | — 0–50 |
#### Пример промпта
> «Ролик готов?»
### Выбрать версию
`tool choose_version`
- **Области доступа:** `projects:write`
- **MCP:** можно повторять
Делает версию текущей по id: любую из get\_project.versions, файл которой хранится (hasFile), — например, ролик до пересборки. Монтаж отдаёт одну версию; прежний ролик остаётся в истории.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `versionId` _(обязательное)_ | `integer` | — ≥ 1 |
#### Пример промпта
> «Верни прежнюю версию»
### Пересобрать с новыми параметрами
`tool remount_project`
- **Области доступа:** `montage:run`
- **Цена:** цена монтажа, подтверждается confirmCost
- **MCP:** удаляет данные
Заново запускает ИИ-монтаж с новыми настройками или пожеланиями; ручные правки сбрасываются. Платно, с confirmCost.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `settings` _(обязательное)_ | `object` | Любая часть настроек монтажа; недостающее — по умолчанию, неизвестные id — по умолчанию |
| `settings.templateId` | `string` | Шаблон: `bold`, `clean`, `pop` |
| `settings.fontId` | `string` | Шрифт субтитров: punch, poster, block, wide, editorial, rounded, script, mono |
| `settings.colorId` | `string` | Акцент: amber, azure, lime, crimson, fuchsia, mint, violet, white |
| `settings.subtitles` | `object` | Вид субтитров; частичная правка сохраняет остальные поля. Новое `design` без `highlight`/`animation`/`words` возвращает их к `auto` |
| `settings.subtitles.enabled` | `boolean` | |
| `settings.subtitles.design` | `string` | — `dynamic` · `karaoke` · `classic` · `minimal` · `pop` · `box` · `word` |
| `settings.subtitles.size` | `string` | — `small` · `medium` · `large` |
| `settings.subtitles.position` | `string` | `auto` — каждая фраза там, где в кадре свободнее (не на лице, хуке, плашках, титрах) — `auto` · `top` · `center` · `bottom` |
| `settings.subtitles.speakerColors` | `boolean` | Слова каждого говорящего — своим цветом |
| `settings.subtitles.highlight` | `string` | Слово, которое звучит: цвет, увеличение, плашка, подчёркивание; `auto` — как задумано оформлением — `auto` · `none` · `color` · `pop` · `box` · `underline` |
| `settings.subtitles.animation` | `string` | Появление фразы; `words` — по словам, по мере речи — `auto` · `none` · `fade` · `pop` · `slide` · `words` |
| `settings.subtitles.words` | `string` | Сколько слов на экране сразу — `auto` · `one` · `few` · `line` · `phrase` |
| `settings.subtitles.letterCase` | `string` | Регистр; `auto` — как задумано шрифтом — `auto` · `upper` · `normal` |
| `settings.params` | `object` | Параметры монтажа, см. `GET /v1/styles` → `params` |
| `settings.params.emoji` | `boolean` | |
| `settings.params.soundEffects` | `boolean` | |
| `settings.params.mediaCards` | `boolean` | |
| `settings.params.plaques` | `boolean` | |
| `settings.params.cameraMotion` | `boolean` | |
| `settings.params.introZoom` | `boolean` | |
| `settings.params.hook` | `boolean` | |
| `settings.smartCut` | `boolean` | Умная нарезка: убрать паузы и повторы |
| `settings.targetDurationSec` | `15 \| 30 \| 60 \| 90 \| null` | Длительность; `null` — решает ИИ (до 90 с) |
| `settings.language` | `string` | — `auto` · `ru` · `en` |
| `settings.direction` | `object` | |
| `settings.direction.mode` | `string` | — `auto` · `talking` · `story` · `product` · `aesthetic` |
| `settings.direction.pace` | `string` | — `calm` · `balanced` · `dynamic` |
| `settings.direction.effects` | `string` | — `off` · `light` · `bold` |
| `settings.direction.narration` | `boolean` | Закадровый голос ИИ |
| `settings.direction.voice` | `string` | — `warm` · `soft` · `confident` · `deep` |
| `brief` | `string` | — ≤ 600 |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Пересобери спокойнее, без эффектов»
### Повторить неудачный запуск
`tool retry_project`
- **Области доступа:** `montage:run`
- **Цена:** как у неудавшегося запуска, подтверждается confirmCost
Повторяет неудачный или остановленный запуск с первого незавершённого этапа. Бесплатный запуск — бесплатно.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Попробуй смонтировать ещё раз»
### Остановить запуск
`tool cancel_project`
- **Области доступа:** `projects:write`
- **MCP:** удаляет данные
Останавливает монтаж или экспорт; резерв токенов возвращается. Экспорт оставляет прежний ролик.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
#### Пример промпта
> «Останови текущий монтаж»
### Переименовать проект
`tool rename_project`
- **Области доступа:** `projects:write`
- **MCP:** можно повторять
Меняет название проекта.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `title` _(обязательное)_ | `string` | — ≤ 120 |
#### Пример промпта
> «Назови его «Утренняя рутина»»
### Удалить проект
`tool delete_project`
- **Области доступа:** `projects:write`
- **MCP:** удаляет данные
Удаляет проект, ролик и материалы навсегда. Сначала спросите подтверждение.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
#### Пример промпта
> «Удали тестовый проект»
Что можно попросить:
- «Сделай ролик из этих трёх видео в формате 1:1 и собери его сам.»
- «Покажи мои черновики и переименуй последний в „Утро в кофейне“.»
- «Смонтируй это интервью ИИ-режиссёром Slicer — сначала скажи цену.»
- «Верни ролик, который был до пересборки.»
## Правки
Всё, чем ассистент монтирует ролик, — бесплатно.
`get_transcript` отдаёт ролик текстом — ассистент видит фрагменты и их время, что сказано, что вырезано и где стоят элементы. `edit_project` применяет правки операциями единого каталога — те же, что в редакторе, у ИИ-помощника, у режиссёра в «Чате» и в [API](https://docs.slicer.media/api/editing/#operations): вырезать слова и паузы, разделить, подрезать, переставить и дублировать фрагменты, поставить стоп-кадр, заменить картинку фрагмента и поставить исходник в ролик, исправить субтитры, акценты и текст фразы, добавить и поправить хук, плашки, карточки, титры, эмодзи, наезды и маркеры, поменять скорость, звук, переходы, эффекты и цвет (фильтр, «Настроить», LUT), бесплатную обработку и движение камеры, поставить звуки, [музыку и голос](https://docs.slicer.media/api/editing/#ops-audio), [фото и видео поверх ролика](https://docs.slicer.media/api/editing/#ops-inserts), перенести оформление фрагмента на другие, обложку и формат кадра. Где речи нет, элементы ставятся по времени ролика ([Элементы по времени](https://docs.slicer.media/api/editing/#by-time)).
Например: «Раздели второй фрагмент на 4-й секунде и поставь в конце стоп-кадр», «Поставь трек из исходников потише и подгони его под длину ролика», «Покажи фото готового блюда окном поверх второго видео».
`auto_color` выравнивает цвет фрагмента или подбирает под него остальные — без ИИ ([Автобаланс цвета](https://docs.slicer.media/api/editing/#auto-color)). `set_style` меняет шаблон, шрифт, цвет и вид субтитров: оформление, размер, положение, выделение слова, которое звучит, появление фразы, число слов на экране и регистр ([поля](https://docs.slicer.media/api/editing/#style-subtitles)). Правка частичная — чего нет в просьбе, остаётся как было.
### Ролик текстом
`tool get_transcript`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Готовый ролик текстом: фрагменты с id слов, вырезанное — в \[скобках\], акценты — \*, неиспользованная речь, графика с id; rev для edit\_project.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
#### Пример промпта
> «Что говорится в ролике?»
### Править ролик
`tool edit_project`
- **Области доступа:** `projects:write`
Применяет операции правки к готовому ролику — бесплатно, те же операции, что в редакторе. Сначала get\_transcript; id — только оттуда.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `rev` _(обязательное)_ | `integer` | Document revision from get\_transcript; edits are rejected if the video changed since |
| `operations` _(обязательное)_ | `object[]` | — 1–80 |
#### Пример промпта
> «Вырежи второе предложение и добавь наезд на «результаты»»
### Автобаланс цвета
`tool auto_color`
- **Области доступа:** `projects:write`
Выравнивает цвет фрагмента без ИИ и бесплатно (режим «auto») или делает остальные фрагменты похожими на него (режим «match», с его фильтром и LUT). Результат сохраняется.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `rev` _(обязательное)_ | `integer` | Document revision from get\_transcript; edits are rejected if the video changed since |
| `blockId` _(обязательное)_ | `string` | — ≤ 64 |
| `mode` _(обязательное)_ | `string` | — `auto` · `match` |
#### Пример промпта
> «Сделай цвет всех фрагментов как у первого»
### Сменить стиль
`tool set_style`
- **Области доступа:** `projects:write`
- **MCP:** можно повторять
Меняет шаблон, шрифт, акцент, оформление и положение субтитров, выделение слова, появление фразы, число слов на экране и регистр — бесплатно; в файле — после export\_video.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `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` | |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
#### Пример промпта
> «Сделай, чтобы слово, которое звучит, выпрыгивало в субтитрах»
Что можно попросить:
- «Начни с фото, убери паузы и добавь хук „Монтаж за 3 минуты“.»
- «Добавь в начало титр „Утро в кофейне“ с появлением по буквам и поставь маркер „музыка“ на 10-й секунде.»
- «Сделай все фрагменты как первый: тот же фильтр и переход.»
- «Выровняй цвет второго фрагмента, подгони под него остальные и поставь LUT „Золотой час“ на 60 %.»
- «Смени шрифт на editorial и цвет на мятный.»
- «Сделай, чтобы слово, которое звучит, выпрыгивало.»
## Свой режиссёр
Ассистент монтирует ролик сам — бесплатно, а Slicer применяет к его плану правила своего ИИ-режиссёра на сервере. `get_director_brief` отдаёт материал (речь по id слов, паузы, дубли, пожелания), общие советы и схемы плана и наблюдений по кадрам; переданные настройки режиссуры — тип ролика, темп, эффекты, длина, хук, плашки, эмодзи, наезды — сохраняются в проекте. `get_frames` показывает кадры исходника картинками — до 16 за вызов. `submit_director_plan` принимает план и наблюдения, сохраняет ролик новой ревизией и отвечает исправлениями, замечаниями и роликом текстом; по замечаниям ассистент правит план и присылает снова. Правил режиссёра Slicer ассистент не получает. Как это работает по шагам и пример — [Свой режиссёр](https://docs.slicer.media/mcp/own-director/).
### Бриф режиссёра (свой режиссёр)
`tool get_director_brief`
- **Области доступа:** `projects:write`
- **MCP:** можно повторять
Бесплатно. Чтобы вы монтировали со Slicer: материал (речь по id слов, паузы, дубли, пожелания), исходники, общие советы и схемы плана и наблюдений. Кадры — get\_frames; план и наблюдения — submit\_director\_plan, правила режиссёра Slicer работают там. Настройки, если переданы, сохраняются в проекте.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `mode` | `string` | Video type — `auto` · `talking` · `story` · `product` · `aesthetic` |
| `pace` | `string` | — `calm` · `balanced` · `dynamic` |
| `effects` | `string` | — `off` · `light` · `bold` |
| `targetDurationSec` | `integer \| null` | Target length, s; null — up to the director (≤ 90 s) — 10–180 |
| `hook` | `boolean` | |
| `plaques` | `boolean` | |
| `emoji` | `boolean` | |
| `cameraMotion` | `boolean` | |
#### Пример промпта
> «Смонтируй этот ролик сам, как режиссёр Slicer»
### Посмотреть кадры
`tool get_frames`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Бесплатно. Кадры исходника картинками (до 16 за вызов, 512 px): в заданные секунды или равномерно по отрезку. Сначала по несколько кадров, затем подробнее там, где действие.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `sourceIndex` _(обязательное)_ | `integer` | |
| `times` | `number[]` | Seconds of the source — 1–16 |
| `from` | `number` | |
| `to` | `number` | |
| `count` | `integer` | — 1–16 |
#### Пример промпта
> «Покажи, что происходит во втором ролике»
### Применить свой план режиссёра
`tool submit_director_plan`
- **Области доступа:** `projects:write`
Бесплатно. План (planSchema) становится роликом: Slicer применяет свои правила режиссёра на сервере и сохраняет новую ревизию. В ответе — исправления, замечания (поправьте и пришлите снова) и ролик текстом; дальше edit\_project и export\_video.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `rev` _(обязательное)_ | `integer` | Document revision from get\_transcript; edits are rejected if the video changed since |
| `plan` _(обязательное)_ | `Record` | The plan object in planSchema |
| `scenes` | `Record[]` | What you saw in the frames, in scenesSchema — 0–400 |
#### Пример промпта
> «Вот план — собери ролик»
Что можно попросить:
- «Смонтируй этот ролик в Slicer сам: 30 секунд, динамичный темп.»
- «Посмотри кадры второго видео и найди момент, где видно готовое блюдо.»
- «Поправь план по замечаниям Slicer и пришли его снова.»
## Субтитры из речи
В проекте, который создал ассистент, речь ещё не распознана, поэтому субтитров нет. `transcribe_speech` распознаёт речь исходников — как кнопка **Субтитры из речи** в редакторе ([Субтитры из речи](https://docs.slicer.media/guide/editor/speech/#speech)). После этого субтитры идут за речью, в тексте ролика появляются слова с id, и ассистент может править субтитры, выделять акценты и ставить элементы на слова.
Это платная ИИ-функция — по себестоимости за минуту звука, без наценки:
1. Ассистент вызывает `transcribe_speech` без `confirmCost` и получает ожидаемую цену (`estimate`) и предельную (`cost`).
2. Показывает цену вам и после вашего согласия повторяет вызов с `confirmCost`, равным предельной.
3. Распознавание идёт в фоне: ход — `get_transcribe_jobs` (идёт, готово или не получилось), слова — в `get_transcript`.
Спишется фактическая себестоимость, не больше предельной; если распознавание не получилось, токены вернутся. По умолчанию распознаются все исходники со звуком, где речь ещё не распознана; `sources` выбирает конкретные, `language` — язык речи (`auto` или двухбуквенный код).
### Субтитры из речи
`tool transcribe_speech`
- **Области доступа:** `montage:run`
- **Цена:** по себестоимости ИИ за минуту звука без наценки: в цене — ожидаемая (estimate) и предельная (cost)
Распознаёт речь исходников проекта — после этого субтитры идут за речью (у ручного проекта до этого субтитров нет). В фоне: ход — get\_transcribe\_jobs, слова — get\_transcript. Платно, с confirmCost.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `sources` | `integer[]` | Source indexes (default — all with sound and no recognised speech) — 1–40 |
| `language` | `string` | Speech language: auto or a two-letter code |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Добавь субтитры к интервью»
### Ход распознавания речи
`tool get_transcribe_jobs`
- **Области доступа:** `projects:read`
- **MCP:** только чтение
Задачи распознавания речи проекта: идёт, готово или не получилось (тогда токены возвращаются).
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
#### Пример промпта
> «Субтитры уже готовы?»
Что можно попросить:
- «Добавь субтитры к интервью — сначала скажи, сколько это стоит.»
- «Субтитры уже готовы? Тогда выдели акцентом ключевые слова.»
## Платные ИИ-функции Slicer
Токены тратят только ИИ-функции самого Slicer. Ассистент их предлагает, но сам не запускает: каждая без `confirmCost` называет цену, и только после вашего согласия — работает.
| Функция | Инструменты | Цена |
| --- | --- | --- |
| ИИ-монтаж режиссёром Slicer — ролик, проверенный режиссёром | `create_project` с `mode: "ai"`, `remount_project`, `retry_project` | 24 токена за ролик до 90 секунд, первый ролик бесплатный |
| Субтитры из речи | `transcribe_speech` | по себестоимости за минуту звука |
| ИИ-помощник Slicer — команда своими словами | `ask_assistant` | по себестоимости |
| Перевод субтитров | `translate_captions` | по себестоимости |
У функций по себестоимости точная цена известна только после выполнения: без `confirmCost` ассистент получает ожидаемую цену (`estimate`) и предельную (`cost`) и должен показать их вам; после согласия списывается фактическая себестоимость, не больше предельной ([Цена по себестоимости](https://docs.slicer.media/mcp/costs/#at-cost)).
Ваш ассистент и сам правит ролик бесплатными операциями, поэтому `ask_assistant` нужен, только если вы хотите, чтобы правки подобрал именно ИИ-помощник Slicer.
### Команда ИИ-помощнику
`tool ask_assistant`
- **Области доступа:** `montage:run`
- **Цена:** по себестоимости ИИ без наценки: в цене — ожидаемая (estimate) и предельная (cost); списывается фактическая, только если что-то изменилось
Собственный ИИ-помощник Slicer правит ролик по команде словами; списывается, только если что-то изменилось. Если можете сами — edit\_project бесплатно.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `command` _(обязательное)_ | `string` | — ≤ 500 |
| `rev` _(обязательное)_ | `integer` | Document revision from get\_transcript; edits are rejected if the video changed since |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Сделай динамичнее и сократи до 30 секунд»
### Перевести субтитры
`tool translate_captions`
- **Области доступа:** `montage:run`
- **Цена:** по себестоимости ИИ без наценки: в цене — ожидаемая (estimate) и предельная (cost); списывается фактическая, только если перевод получился
Переводит субтитры, хук, плашки и подписи карточек; результат сохраняется. Платно, с confirmCost.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `language` _(обязательное)_ | `string` | — `en` · `es` · `pt` · `de` · `fr` · `it` · `pl` · `tr` · `id` · `uk` · `ru` |
| `rev` _(обязательное)_ | `integer` | Document revision from get\_transcript; edits are rejected if the video changed since |
| `confirmCost` | `integer` | Price in tokens the user explicitly agreed to. Omit it first: the tool returns a quote and starts nothing. Then show the price to the user and call again with confirmCost equal to it |
#### Пример промпта
> «Переведи субтитры на испанский»
Что можно попросить:
- «Переведи субтитры на английский — сначала скажи цену.»
## Экспорт
`export_video` рендерит ролик по текущему документу — бесплатно — и при желании публикует его в подключённые соцсети (нужен доступ `publish`). Подключать соцсети и публиковать в TikTok можно только в приложении Slicer.
### Экспорт и публикация
`tool export_video`
- **Области доступа:** `projects:write`
- **MCP:** обращается к внешним адресам
Рендерит ролик по текущим правкам (бесплатно) и при желании публикует после рендера в YouTube, Instagram или VK (нужна область publish; TikTok — только из приложения).
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `projectId` _(обязательное)_ | `integer` | Project id — ≥ 1 |
| `profile` | `object` | |
| `profile.container` | `string` | — `mp4` · `mov` |
| `profile.codec` | `string` | — `h264` · `hevc` |
| `profile.resolution` | `string` | — `720p` · `1080p` · `1440p` · `2160p` |
| `profile.fps` | `24 \| 25 \| 30` | |
| `profile.quality` | `string` | — `balanced` · `high` · `max` |
| `profile.colorDepth` | `8 \| 10` | 10 бит — только с HEVC |
| `profile.audioBitrate` | `128 \| 192 \| 256 \| 320` | |
| `profile.loudness` | `-14 \| -16 \| -23` | Громкость, LUFS |
| `publish` | `object[]` | — 0–8 |
| `publish[].accountId` _(обязательное)_ | `integer` | Подключённый аккаунт из GET /v1/social/accounts |
| `publish[].title` | `string` | — ≤ 150 |
| `publish[].caption` | `string` | — ≤ 5000 |
| `publish[].options` | `object` | Настройки платформы: `{ youtube: { privacy, madeForKids } }`, `{ instagram: { shareToFeed } }`, `{ vk: { privacy, wallpost, groupId } }`, `aiGenerated` |
#### Пример промпта
> «Экспортируй в 4K и опубликуй на YouTube по ссылке»
### Подключённые соцсети
`tool list_social_accounts`
- **Области доступа:** `publish`
- **MCP:** только чтение
Соцсети, подключённые в приложении Slicer; их id — для export\_video → publish.
#### Параметры
Без параметров.
#### Пример промпта
> «Куда я могу опубликовать?»
Что можно попросить:
- «Экспортируй в 4K для YouTube.»
- «Опубликуй ролик в YouTube Shorts с описанием и хэштегами.»
## Документация
Ассистент может сам искать ответы в этой документации — например, если вы спрашиваете, как работает функция редактора или сколько стоит операция. Инструменты читают только публичные страницы docs.slicer.media.
### Поиск по документации
`tool search_docs`
- **Области доступа:** любой токен
- **MCP:** только чтение · обращается к внешним адресам
Ищет по docs.slicer.media и возвращает подходящие страницы; прочитать — read\_doc.
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `query` _(обязательное)_ | `string` | — ≤ 200 |
| `language` | `string` | — `ru` · `en` |
#### Пример промпта
> «Как добавить музыку в ролик в Slicer?»
### Прочитать страницу документации
`tool read_doc`
- **Области доступа:** любой токен
- **MCP:** только чтение · обращается к внешним адресам
Возвращает страницу docs.slicer.media в Markdown по пути (например, /guide/editor/timeline/).
#### Параметры
| Поле | Тип | Описание |
| --- | --- | --- |
| `path` _(обязательное)_ | `string` | — ≤ 200 |
| `language` | `string` | — `ru` · `en` |
#### Пример промпта
> «Прочитай страницу о горячих клавишах Slicer»
## Что дальше
[ПромптыГотовые сценарии одной командой.](https://docs.slicer.media/mcp/prompts/)[Примеры сценариевРазговоры с ассистентом от начала до конца.](https://docs.slicer.media/mcp/examples/)[ОграниченияЧто ассистент пока не может.](https://docs.slicer.media/mcp/limits/)