# API 1.7.0: нарезка, музыка, голос, субтитры из речи

> Правки через API и MCP умеют всё, что таймлайн: нарезку, стоп-кадр, музыку, голос, вставки. Новое — субтитры из речи по себестоимости.

Источник: https://docs.slicer.media/changelog/api-1-7-editing/

Единый каталог операций правки пополнился — новые операции работают в `POST /v1/projects/{id}/edits`, в инструменте MCP `edit_project`, у ИИ-помощника и режиссёра в «Чате». Все они бесплатны.

## Нарезка и вид фрагментов

-   `split_block`, `trim_block`, `duplicate_block` — разделить фрагмент в момент ролика, подрезать или удлинить его с начала или конца, дублировать.
-   `freeze_frame` и `set_hold` — стоп-кадр и его длина.
-   `replace_source` — показать в фрагменте другой исходник; у фрагмента с речью новая картинка ложится поверх вставкой.
-   `set_process` — бесплатная обработка: обратная перемотка, стабилизация, шумоподавление, улучшение звука.
-   `apply_keyframe_preset` — движение камеры на весь фрагмент: наезд, отъезд, панорама.
-   `tune_block` — новое поле `background`: размытый фон или цвет за вписанным кадром.

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

-   `set_music`, `remove_music` — трек из исходников или медиа проекта, громкость, приглушение под речью, начало, нарастание и затухание.
-   `fit_music`, `fit_to_beats` — трек под длину ролика, склейки видеоряда под биты.
-   `add_voice`, `move_voice`, `trim_voice`, `set_voice_volume`, `remove_voice` — запись голоса на дорожке.

## Вставки и элементы

-   `add_insert`, `update_insert`, `remove_insert` — свои фото и видео поверх ролика, во весь кадр или окном.
-   `update_plaque`, `update_card`, `update_zoom` — правка плашки, карточки (подпись, своё фото) и наезда на месте.
-   `set_element_position` — сдвинуть эмодзи, карточку или плашку по кадру.
-   `set_phrase_text`, `reset_phrase_text` — текст целой фразы в субтитрах.
-   `move_element` — теперь переносит и звуки, и маркеры.

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

-   `POST /v1/projects/{id}/transcribe` — распознать речь исходников, как **Субтитры из речи** в редакторе: после этого у проекта без ИИ-режиссёра появляются субтитры, а в тексте ролика — слова с `id`. Поля `sources` и `language` необязательны. Работает по себестоимости за минуту звука: без `confirmCost` ответ — цена (`Quote` с `estimate` и `cost`), с ним — запуск в фоне.
-   `GET /v1/projects/{id}/transcribe` — задачи распознавания: идёт, готово или не получилось (тогда токены возвращаются).
-   `POST /v1/estimate` — новый вид `transcribe` (нужен `projectId`).
-   MCP — инструменты `transcribe_speech` и `get_transcribe_jobs`.

Новые причины пропуска: `block_or_source_not_found`, `audio_not_found`, `no_music_or_beats`, `recording_not_found`, `media_or_place_not_found`, `word_not_found`. Клиентам ничего менять не нужно — все изменения внутри `/v1`.

[Правки ролика](https://docs.slicer.media/api/editing/#operations) · [Субтитры из речи](https://docs.slicer.media/api/editing/#transcribe) · [Музыка и голос](https://docs.slicer.media/api/editing/#ops-audio) · [Свои фото и видео поверх ролика](https://docs.slicer.media/api/editing/#ops-inserts) · [История версий API](https://docs.slicer.media/api/versioning/#history)