pastorsimon1798/mcp-video

Накладывает несколько аудиодорожек друг на друга с регулировкой громкости. Микширует несколько WAV-файлов с индивидуальным контролем громкости. Аргументы: tracks: Список конфигураций дорожек: - file: Абсолютный путь к WAV-файлу - volume: Множитель громкости 0-1 - start: Смещение по времени начала в секундах - loop: Зациклить ли дорожку (по умолчанию false) duration: Общая длительность выходного сигнала в секундах. output_path: Абсолютный путь для выходного WAV-файла. Результат: Словарь со статусом успеха и output_path.

Применить цепочку аудиоэффектов к WAV-файлу. Обработать аудио через цепочку эффектов: реверберация, фильтрация, нормализация. Аргументы: input_path: Абсолютный путь к входному WAV-файлу. output_path: Абсолютный путь для выходного WAV-файла. effects: Список конфигураций эффектов с: - type: "lowpass", "reverb", "normalize", "fade" - Дополнительные параметры для каждого типа эффекта Возвращает: Словарь с статусом успеха и output_path.

Генерирует предустановленные звуковые элементы дизайна. Предварительно настроенные звуковые эффекты для типовых сценариев использования. Внешние аудиофайлы не требуются. Доступные пресеты: - UI: ui-blip, ui-click, ui-tap, ui-whoosh-up, ui-whoosh-down - Ambient: drone-low, drone-mid, drone-tech - Notifications: chime-success, chime-error, chime-notification - Data: typing, scan, processing, data-flow Аргументы: preset: Имя пресета из списка выше. output_path: Абсолютный путь для выходного WAV-файла. pitch: Вариация высоты тона (low, mid, high). По умолчанию mid. duration: Переопределение длительности по умолчанию (в секундах). intensity: Интенсивность эффекта от 0 до 1. По умолчанию 0.5. Возвращает: Словарь со статусом успеха и output_path.

Составляет несколько аудиособытий в последовательность по времени. Создаёт многослойную аудиодорожку из нескольких синхронизированных звуковых событий. Аргументы: sequence: Список аудиособытий, каждое содержит: - type: "tone", "preset" или "whoosh" - at: Время начала в секундах - duration: Длительность события в секундах - freq/frequency: Для тонов (Гц) - name: Для пресетов (имя пресета) - volume: Амплитуда 0-1 - waveform: Для тонов (sine, square и т.д.) output_path: Абсолютный путь к выходному WAV-файлу. Возвращает: Словарь с полями success и output_path.

Генерирует аудио процедурно с помощью синтеза. Создаёт WAV-файлы с нуля на основе математических форм сигналов. Внешние аудиофайлы не требуются. Поддерживает огибающие, реверберацию, фильтрацию и эффекты затухания. Args: output_path: Абсолютный путь к выходному WAV-файлу. waveform: Тип формы сигнала (sine, square, sawtooth, triangle, noise). По умолчанию sine. frequency: Базовая частота в Гц. По умолчанию 440 (нота A4). duration: Длительность в секундах. По умолчанию 1.0. volume: Амплитуда 0–1. По умолчанию 0.5. effects: Опциональный словарь эффектов с ключами: - envelope: {"attack", "decay", "sustain", "release"} в секундах - fade_in: Длительность нарастания в секундах - fade_out: Длительность затухания в секундах - reverb: {"room_size", "damping", "wet_level"} - lowpass: Частота среза в Гц Returns: Словарь с статусом выполнения и output_path.

Применение хроматической аберрации - разделение RGB-каналов. Создает модный RGB-эффект расщепления, популярный в техно/глитч-эстетике. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь для выходного видео. intensity: величина смещения в пикселях. По умолчанию 2.0. angle: направление разделения в градусах. По умолчанию 0 (горизонтально). Возвращает: Словарь с статусом выполнения и output_path.

Применить bloom/glow эффект для ярких участков. Создает мягкое свечение вокруг ярких областей видео. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь для выходного видео. intensity: интенсивность свечения 0-1. По умолчанию 0.5. radius: радиус размытия в пикселях. По умолчанию 10. threshold: порог яркости 0-1. По умолчанию 0.7. Возвращает: Словарь со статусом успеха и output_path.

Применяет зернистость плёнки или цифровой шум. Добавляет текстурный шум к видео для винтажной или lo-fi эстетики. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. intensity: Степень шума от 0 до 1. По умолчанию 0.05. mode: Тип шума (film, digital, color). По умолчанию film. animated: Меняется ли шум от кадра к кадру. По умолчанию true. Returns: Словарь с статусом успеха и output_path.

Накладывает оверлей в стиле CRT-сканирования. Имитирует эффект растровых линий старого CRT-монитора с возможностью мерцания. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. line_height: Пикселей на строку развёртки. По умолчанию 2. opacity: Непрозрачность линий от 0 до 1. По умолчанию 0.3. flicker: Изменение яркости от 0 до 1. По умолчанию 0.1. Возвращает: Словарь с признаком успеха и output_path.

Применяет эффект виньетки - затемняет края. Создаёт затемнённую окантовку, которая привлекает внимание к центру кадра. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. intensity: Степень затемнения, от 0 до 1. По умолчанию 0.5. radius: Радиус виньетки, от 0 до 1 (1 - край кадра). По умолчанию 0.8. smoothness: Мягкость края, от 0 до 1. По умолчанию 0.5. Возвращает: Словарь со статусом выполнения и output_path.

Применяет эффект CMYK-глитча с разделением. Сдвигает RGB-каналы с интервалом 90 градусов, имитируя ошибки совмещения четырёхпластинчатой офсетной печати. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Расстояние сдвига в пикселях. По умолчанию 8. angle: Базовый угол в градусах. По умолчанию 0. noise: Амплитуда шума на кадр (от 0 до 1). По умолчанию 0. Возвращает: Словарь со статусом выполнения и output_path.

Применяет эффект datamoshing-глитча. Имитирует повреждение P-кадров, при котором смещение накапливается между кадрами, а затем периодически сбрасывается, воспроизводя настоящие артефакты datamosh. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. drift: Максимальная величина смещения в пикселях. По умолчанию 20. iframe_interval: Интервал кадров для сброса смещения. По умолчанию 30. Возвращает: Словарь с флагом успеха и output_path.

Применяет эффект точечного сплэттинга на основе глубины (требуется Node.js + GPU). Извлекает псевдоглубину из яркости и отображает изображение в виде рассеянных точек, создавая трёхмерный вид, похожий на частицы. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. depth_scale: Интенсивность извлечения глубины. По умолчанию 1.0. spread: Расстояние разброса точек в пикселях. По умолчанию 10.0. point_size: Размер каждой сплэттированной точки. По умолчанию 3.0. threshold: Порог отсечения глубины (0-1). По умолчанию 0.5. Возвращает: Dict с статусом успеха и output_path.

Применяет эффект глюка с цифровой обратной связью (требуется Node.js + GPU). Покадровая обратная связь с трансформацией масштаба/поворота. Каждый кадр смешивается с масштабированной и повёрнутой версией предыдущего выхода, создавая призрачные шлейфы и рекурсивные визуальные паттерны. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. feedback_mix: Смешивание текущего кадра и обратной связи (0-1). По умолчанию 0.5. scale: Масштаб UV для предыдущего кадра. По умолчанию 1.0. rotation: Поворот в градусах. По умолчанию 0.0. decay: Прозрачность призрачного шлейфа (0-1). По умолчанию 0.9. Возвращает: Словарь со статусом успеха и output_path.

Применить эффект макроблокинга (глитч). Имитирует артефакты кодека: уменьшает и увеличивает разрешение, создавая блочную пикселизацию в сочетании с постеризацией цвета. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. block_size: Размер блока в пикселях. По умолчанию 16. intensity: Наложение с оригиналом (0-1). По умолчанию 0.7. color_reduction: Снижение цветового уровня (0-1). По умолчанию 0.3. Returns: Dict с состоянием успеха и output_path.

Примени эффект рендеринга облака точек (требуется Node.js + GPU). Сэмплирует изображение как разбросанные точки, расположенные в 3D-повёрнутой сетке, со смещением по глубине, создающим объёмный вид. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь к выходному видео. density: Плотность сэмплирования точек (0-1). По умолчанию 0.5. point_size: Размер каждой точки. По умолчанию 2.0. rotation: Угол 3D-поворота в градусах. По умолчанию 0.0. depth: Интенсивность смещения по глубине. По умолчанию 1.0. Возвращает: Словарь с успешным статусом и output_path.

Применяет эффект глитча со смещением каналов RGB. Сдвигает красный и синий каналы в противоположные стороны для эффекта хроматического расщепления. Опционально добавляет покадровый шум для дрожащего эффекта. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Расстояние сдвига в пикселях. По умолчанию 10.0. angle: Направление сдвига в градусах. По умолчанию 0 (горизонтальное). noise: Амплитуда покадрового шума (0-1). По умолчанию 0. Возвращает: Словарь со статусом успеха и путем output_path.

Применяет эффект глитча с дрожанием строк развёртки. Смещает случайные горизонтальные строки пикселей, имитируя неисправность ЭЛТ. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. jitter_amount: Максимальное горизонтальное смещение в пикселях. По умолчанию 15. frequency: Доля строк, к которым применяется эффект (0-1). По умолчанию 0.3. speed: Множитель скорости анимации. По умолчанию 5. row_height: Высота каждой полосы дрожания в пикселях. По умолчанию 4. Возвращает: Словарь с флагом успеха и output_path.

Применяет эффект разрыва экрана (screen tearing). Создаёт горизонтальные полосы разрыва на разных позициях Y, которые смещаются влево/вправо с течением времени. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь к выходному видео. tear_count: количество полос разрыва. По умолчанию 5. offset_range: максимальное горизонтальное смещение в пикселях. По умолчанию 80. speed: скорость анимации. По умолчанию 3. Возвращает: Словарь со статусом успеха и output_path.

Применить эффект временного смещения slit-scan (требуется Node.js + GPU). Каждая строка/столбец выходного изображения берется из разных прошлых кадров, создавая эффект размытия во времени, напоминающий slit-scan фотографию. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. depth: Количество используемых прошлых кадров (1-120). По умолчанию 30. direction: 0=сверху вниз, 1=снизу вверх, 2=слева направо, 3=справа налево. По умолчанию 0. Returns: Словарь со статусом успеха и output_path.

Применяет эффект турбулентного смещения (глитч). Использует многослойные выражения sin/cos на разных частотах, чтобы аппроксимировать фрактальный шум броуновского движения для органичного смещения. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Величина смещения в пикселях. По умолчанию 20. scale: Базовая частота шума. По умолчанию 0.01. speed: Скорость анимации. По умолчанию 1. octaves: Количество октав шума (1-5). По умолчанию 3. Возвращает: Словарь со статусом успеха и output_path.

Применяет эффект глюка из-за ошибки трекинга VHS. Имитирует проблемы трекинга VHS-ленты: цветовой размыв, полосы прокрутки и аналоговый шум. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. tracking: Интенсивность ошибки трекинга (0-1). По умолчанию 0.5. noise_amount: Интенсивность VHS-шума (0-1). По умолчанию 0.03. color_bleed: Сдвиг красного канала в пикселях. По умолчанию 3. roll_speed: Скорость вертикальной прокрутки. По умолчанию 2. Возвращает: Словарь с статусом успеха и output_path.

Устанавливает блок из каталога Hyperframes. Аргументы: project_path: Абсолютный путь к каталогу проекта Hyperframes. block_name: Имя элемента реестра (например, claude-code-window, shader-wipe).

Измеряет скорость рендеринга и размер файла Hyperframes.

Захватывает веб-сайт в виде редактируемых компонентов Hyperframes.

Просматривает каталог блоков/компонентов Hyperframes.

Перечисляет композиции в проекте Hyperframes. Аргументы: project_path: Абсолютный путь к каталогу проекта Hyperframes.

Запустить диагностику окружения Hyperframes.

Выводит метаданные проекта Hyperframes.

Создаёт новый проект Hyperframes. Аргументы: name: Название проекта. output_dir: Каталог для создания проекта. По умолчанию — текущий каталог. template: Шаблон проекта (blank, warm-grain, swiss-grid). По умолчанию blank. video: Необязательное исходное видео для начальной загрузки проекта. audio: Необязательный исходный аудиофайл для начальной загрузки проекта. skip_transcribe: Пропустить транскрибацию Whisper во время начальной загрузки медиа. model: Модель Whisper для транскрибации. language: Код языка для транскрибации. tailwind: Добавить поддержку Tailwind CSS для выполнения в браузере. resolution: Предустановка размера холста Hyperframes.

Проверяет отрисованную компоновку на наличие переполнения и визуальных проблем.

Запускает студию предварительного просмотра Hyperframes для живого просмотра. Args: project_path: Абсолютный путь к каталогу проекта Hyperframes. port: Порт для сервера предварительного просмотра (по умолчанию 3002).

Вырезает человека или продукт из стоп-кадра или видео. Модель по умолчанию u2net_human_seg работает только с людьми (говорящие головы).Для продуктов, упаковки, ювелирных изделий, бутылок, керамики или любых других объектов, не являющихся людьми, передайте model="birefnet-general" (требуется pip install "kinocut[object-matte]"). Никогда не переключается на модель для людей. Вызовите info=True без входных данных, чтобы получить список моделей и заполнить кэш без скачивания. Руководство: docs/PRODUCT_MATTE.md.

Преобразует композицию Hyperframes в видео. Параметры: project_path: Абсолютный путь к каталогу проекта Hyperframes. output_path: Куда сохранить видео. Создаётся автоматически, если не указан. fps: Частота кадров (24, 30, 60). width: Ширина вывода в пикселях. height: Высота вывода в пикселях. quality: Качество рендера (draft, standard, high). По умолчанию: standard. format: Выходной формат (mp4, webm, mov, png-sequence). По умолчанию: mp4. resolution: Пресет разрешения Hyperframes (landscape, portrait, landscape-4k, portrait-4k, 1080p, 4k, uhd). composition: Конкретный файл композиции для рендера вместо index.html. workers: Количество параллельных процессов рендера (число или 'auto'). По умолчанию: auto. crf: Переопределяет CRF кодека (меньше = лучше качество). variables: Встроенный JSON-объект или строка с данными времени выполнения для композиции. variables_file: Путь к JSON-файлу с данными времени выполнения для композиции.

Захватывает ключевые кадры как PNG-скриншоты для визуальной проверки.

Отрисовывает один кадр как изображение из композиции Hyperframes. Аргументы: project_path: Абсолютный путь к директории проекта Hyperframes. output_path: Место сохранения изображения. Создаётся автоматически, если не указан. frame: Номер кадра для отрисовки (по умолчанию 0). variables: Встроенный JSON-объект или строка с данными выполнения для композиции. variables_file: Путь к JSON-файлу с данными выполнения для композиции.

Преобразует композицию Hyperframes и выполняет постобработку с помощью mcp-video за один шаг. Аргументы: project_path: Абсолютный путь к каталогу проекта Hyperframes. post_process: Список операций постобработки, каждая с ключами 'op' и 'params'. Пример: [{"op": "resize", "params": {"aspect_ratio": "9:16"}}] output_path: Куда сохранить итоговый результат. Автоматически генерируется, если опущен.

Транскрибирует аудио/видео во временные метки на уровне слов или импортирует транскрипты.

Генерирует аудио речи или перечисляет доступные локальные голоса Hyperframes TTS.

Проверяет проект Hyperframes на готовность к рендерингу. Аргументы: project_path: Абсолютный путь к каталогу проекта Hyperframes.

Анализирует изображение продукта или кадр видео - извлекает цвета и опционально генерирует AI-описание. Извлекает доминирующие цвета из изображения. Опционально использует Claude Vision для генерации описания продукта на естественном языке. Параметры: image_path: Абсолютный путь к файлу изображения или видео. Если видео, извлекается репрезентативный кадр. use_ai: Если True, использует Claude Vision для генерации описания (требуется ANTHROPIC_API_KEY). n_colors: Количество доминирующих цветов для извлечения (по умолчанию 5).

Сопоставляет закреплённый кадр устойки с планом/квитанцией (намерение — метаданные аудита). Путь пикселей v1 — только свободная установка среднего RGB-совпадения; intent — обязательные метаданные и не выбирает операции над пикселями. Платная генерация выключена, если не задано allow_paid_gen=True (пока недоступна до настройки). Сухой прогон возвращает план без изменения пикселей. Аргументы: source: Абсолютный путь исходного кадра устойки. reference: Абсолютный путь установочного/эталонного кадра устойки. intent: Обязательный текст аудита (что подразумевал агент); не является директором пикселей на естественном языке. output_dir: Абсолютный путь выходной директории. prefer: 'edit' (по умолчанию) или 'gen'. allow_paid_gen: Явное разрешение платной генерации (по умолчанию False). dry_run: Только план, если True; не выполняет пиксели.

Извлекает доминирующие цвета из изображения или кадра видео. Использует K-means кластеризацию для поиска самых заметных цветов. Возвращает hex-коды, значения RGB, названия цветов CSS и процент покрытия. Аргументы: image_path: Абсолютный путь к файлу изображения или видео. Если видео, извлекает репрезентативный кадр. n_colors: Количество доминирующих цветов для извлечения (1-20, по умолчанию 5).

Создаёт палитру цветовой гармонии из изображения или кадра видео. Извлекает доминантный цвет и генерирует гармоничные цвета на основе теории цвета (complementary, analogous, triadic, split_complementary). Args: image_path: Абсолютный путь к файлу изображения или видео. Если указано видео, извлекает репрезентативный кадр. harmony: Тип гармонии (complementary, analogous, triadic, split_complementary). n_colors: Количество доминантных цветов для построения палитры (по умолчанию 5).

Ищет зарегистрированные MCP-инструменты по ключевому слову. Используйте этот инструмент, когда нужно найти подходящий инструмент для задачи, не читая описания каждого зарегистрированного инструмента. Возвращает подходящие инструменты с их названиями, описаниями и обязательными параметрами. Аргументы: query: Поисковый запрос, например, "blur", "resize", "subtitle", "audio", "trim".

Упаковывает утверждённые рендеры платформы из сохранённого плана. Никогда не публикует.

Загружает сохранённый план шортсов и возвращает предложения без привязки к источнику для проверки.

Генерирует черновики платформы для одобренного кандидата из сохранённого плана.

Добавляет одно решение проверки человеком в сохранённый план shorts (без источника).

Разворачивает один кадр раскадровки в строки prompt и negative_prompt. Аргументы: project_path: Абсолютный путь к каталогу проекта, содержащему style.md и storyboard.md. shot: Идентификатор кадра или номер строки (начиная с 1) из storyboard.md.

Обнаруживает ограниченный публичный набор звуковых операций (сначала локальный, безопасный для JSON).

Рендерит ограниченный локальный микс для минимальной временной шкалы (duration/stem smoke path).

Проверяет payload SoundPlan (или встроенный минимальный план, если он не указан).

Запускает локальный порт проверки fake ASR для хэшей скриптов.

Измеряет громкость в соответствии с политикой доставки по умолчанию на синтезированном аудио.

Рендерит локальный детерминированный голосовой батч из SoundPlan (или минимального плана).

Шлюз отказоустойчивой когезии для пакета кадров и контактного листа. Проверяет разброс яркости и зелёно-голубую заливку теней. Возвращает passed=false с именованными ошибками метрик/кадров, если пакет не проходит. Аргументы: inputs: Абсолютные пути кадров в пакете. output_dir: Абсолютный каталог для квитанции и контактного листа.

Выполняет цветокоррекцию кадров в порядке: коррекция → согласование → внешний вид; опциональный 3D LUT применяется последним. Режим сигнала помечает LUT как выравнивание сигнала (а не косплей под плёнку) и записывает дельты сохранения около-чёрного/около-белого. Аргументы: inputs: Абсолютные пути к кадрам. output_dir: Абсолютный выходной каталог. hero: Опциональный главный кадр для этапа согласования. lut_path: Опциональный абсолютный путь к .cube/.3dl, применяемый последним. signal_mode: Обрабатывает LUT как выравнивание сигнала.

Сопоставляет набор статичных кадров с основным кадром (hero plate) с одним общим коэффициентом WB/экспозиции. Не перезаписывает исходники. Записывает сопоставленные кадры и JSON-отчёт в output_dir. Покадровый автоматический баланс белого отключен (только общие коэффициенты). Args: hero: Абсолютный путь к основному/опорному кадру. inputs: Абсолютные пути к набору статичных кадров. output_dir: Абсолютный путь к каталогу для выходных данных и отчётов.

Многокадровый пакетный рабочий процесс: редакция битов → сопоставление → градация → контроль связности. Аргументы: establish: Абсолютный путь к установочному/главному кадру. beats: Абсолютные пути к кадрам битов. output_dir: Абсолютный путь к выходному каталогу пакета. dry_run: Если True, возвращает только запланированный граф. apply_grade: Выполняет упорядоченную градацию после сопоставления (по умолчанию True). lut_path: Опциональный путь к LUT для этапа просмотра градации. signal_mode: Режим LUT для выравнивания сигнала.

Читает таблицу раскадровки PUSHING CREATION из файла storyboard.md или из директории проекта. Аргументы: path: Абсолютный путь к storyboard.md или к директории проекта, содержащей storyboard.md.

Читает блоки STYLE_ и NEG_ из файла style.md или директории проекта. Аргументы: path: Абсолютный путь к style.md или к директории проекта, содержащей style.md.

Применить глитч-переход между двумя видеофрагментами. Аргументы: clip1_path: Абсолютный путь к первому видеофрагменту. clip2_path: Абсолютный путь ко второму видеофрагменту. output_path: Абсолютный путь для выходного видео. duration: Длительность перехода в секундах (по умолчанию 0.5). intensity: Интенсивность глитча от 0 до 1 (по умолчанию 0.3).

Примени морфинг-переход между двумя видеоклипами.

Применить пиксельный переход между двумя видеоклипами.

Оценивает вердикт по точному соответствию спецификации и доказательства дефектов, не утверждая ничего.

Добавляет, заменяет или смешивает аудиофайл с существующим видео и создаёт новый выходной файл. Исходное видео и аудио доступны только для чтения; output_path создаётся или перезаписывается. Управляет громкостью, затуханием в начале и конце, режимом смешивания/замены, а также опциональным временем начала.

Добавляет процедурно сгенерированный звук к видео. Однократная вспомогательная функция для генерации и добавления звука к видео. Аргументы: input_path: Абсолютный путь к входному видео. audio_config: Словарь конфигурации звука: - drone: {"frequency", "volume"} - фоновый тон - events: список звуковых событий с временными метками output_path: Абсолютный путь для выходного видео. Возвращает: Словарь со статусом успеха и output_path.

Накладывает текст на видео (заголовки, субтитры, водяные знаки). Возвращает JSON {success, output_path}. Используется для вживления одного текстового элемента в видео. Передайте input_path как исходное видео, text — строку для отрисовки, а position/size/color для стилизации; output_path создаётся автоматически, если не указан. Аргументы: input_path: Абсолютный путь к входному видео. text: Текст для наложения. position: Позиция на экране. Именованная (top-left, top-center и т.д.), пиксельная {"x": 100, "y": 50} или процентная {"x_pct": 0.5, "y_pct": 0.5}. font: Путь к файлу шрифта. Используется системный шрифт по умолчанию, если не указан. size: Размер шрифта в пикселях. color: Цвет текста (имя цвета в CSS или hex). shadow: Добавляет тень текста для читаемости. start_time: Момент появления текста (в секундах). Null = всегда виден. duration: Как долго текст виден (в секундах). Требует start_time. output_path: Куда сохранить результат. Создаётся автоматически, если не указан. crf: Переопределить значение CRF (0-51, ниже = лучше качество). По умолчанию 23. preset: Переопределить пресет кодирования FFmpeg (ultrafast, fast, medium, slow, veryslow).

Накладывает несколько текстовых элементов на видео за один проход FFmpeg. Возвращает JSON {success, output_path}. Используйте, когда на одно видео нужно одновременно наложить несколько подписей. Передайте input_path как исходное видео и texts как список словарей наложения (текст плюс опциональные позиция/размер/цвет/тайминг). Аргументы: input_path: Абсолютный путь к входному видео. texts: Список словарей текстовых наложений. Каждый словарь может содержать: - text (str, обязательно) - position (str|dict, по умолчанию "center") - font (str, опционально) - size (int, по умолчанию 48) - color (str, по умолчанию "white") - shadow (bool, по умолчанию True) - start_time (float, опционально) - duration (float, опционально) output_path: Куда сохранить результат. Автоматически генерируется, если опущен. crf: Переопределяет значение CRF (0-51, меньше = лучше качество). По умолчанию 23. preset: Переопределяет пресет кодирования FFmpeg (ultrafast, fast, medium, slow, veryslow). auto_layout: Автоматически распределяет по вертикали стопку текстов с одинаковым именованным положением. По умолчанию False.

Применяет цветокоррекцию к видео - с помощью LUT-файла, пресета стиля или референсного видео. Аргументы: input_path: Видеофайл, к которому применяется коррекция. output_path: Путь для сохранения видео с цветокоррекцией. reference_path: Опциональное референсное видео - если указано, цветовой баланс видео подстраивается под референс (отменяет настройки стиля). style: Пресет стиля. Один из: auto (мягкое поднятие контраста), warm, cool, vintage, cinematic, dramatic, noir (высокий контраст, пониженная насыщенность). lut_path: Опциональный LUT-файл .cube/.3dl, применяется через FFmpeg lut3d - отменяет и референс, и стиль для профессиональных цветовых решений.

Удалить участки тишины из видео.

Обнаруживает изменения сцен в видео.

Разделяет аудио на дорожки-стимы с помощью Demucs.

Транскрибирует речь в текст с помощью Whisper.

Увеличивает разрешение видео с помощью AI super-resolution.

Комплексный анализ видео - расшифровка, метаданные, сцены, аудио, качество, главы, цвета. Принимает локальный путь к файлу или HTTP/HTTPS URL. Прямые ссылки на видео (например https://example.com/clip.mp4) загружаются автоматически. Ссылки на стриминговые платформы (YouTube, Vimeo, TikTok, Twitter/X, Instagram, Twitch, ...) требуют yt-dlp (pip install yt-dlp). Каждый под-анализ независим, поэтому сбой одного не прерывает остальные. Args: input_path: Локальный путь или HTTP/HTTPS URL к видео. whisper_model: Размер модели Whisper (tiny, base, small, medium, large, turbo). language: Код языка для расшифровки (автоопределение, если None). scene_threshold: Чувствительность определения смены сцен 0.0-1.0. include_transcript: Запускает распознавание речи через Whisper (требуется openai-whisper). include_scenes: Определяет смену сцен и их границы. include_audio: Анализирует форму аудиосигнала, пики и участки тишины. include_quality: Запускает проверку визуального качества. include_chapters: Автоматически создаёт метки глав по смене сцен. include_colors: Извлекает доминирующие цвета и расширенные метаданные. output_srt: Необязательный путь для записи SRT-файла субтитров. output_txt: Необязательный путь для записи расшифровки в виде обычного текста. output_md: Необязательный путь для записи расшифровки в Markdown с временными метками. output_json: Необязательный путь для записи полных данных расшифровки в JSON.

Применяет маску изображения к видео с размытием краёв. Аргументы: input_path: Абсолютный путь к входному видео. mask_path: Абсолютный путь к изображению маски (белый = видимая область, чёрный = прозрачная). feather: Степень размытия краёв маски в пикселях (по умолчанию 5). output_path: Путь для сохранения результата. Если не указан, создаётся автоматически.

Микширует зацикленный музыкальный фон под голосовым источником с дакингом и нормализацией громкости. Голос управляет сайдчейн-дакингом и нормализацией громкости. Возвращается детерминированный AudioBedReceipt, а длительность выходного сигнала остаётся привязанной к голосовому источнику. Аргументы: voice_source: Видео/аудио, чей существующий звук (голос/диалог) управляет дакингом и задаёт длительность выходного сигнала. music_path: Фоновая музыка или эмбиент для подмешивания снизу; зацикливается, если короче голоса. output_path: Абсолютный путь для результирующего выходного файла. loop: Зацикливать музыкальный фон, если он короче голоса. По умолчанию True. loop_crossfade: Длительность кроссфейда между повторениями цикла в секундах. По умолчанию 1.5. fade_in: Длительность входного фейда в секундах. По умолчанию 0.0. fade_out: Длительность выходного фейда в секундах. По умолчанию 2.2. target_lufs: Целевой уровень нормализации громкости в LUFS. По умолчанию -16.0. duck_threshold: Уровень сайдчейна, выше которого включается дакинг. По умолчанию 0.02. duck_ratio: Коэффициент компрессии во время звучания голоса. По умолчанию 5.0. duck_attack: Атака дакинга в миллисекундах. По умолчанию 25.0. duck_release: Спад дакинга в миллисекундах. По умолчанию 450.0. music_volume: Базовый уровень музыки до дакинга. По умолчанию 1.0. save_receipt: Опциональный абсолютный путь для записи AudioBedReceipt в JSON. Возвращает: Словарь со success status, output_path, output_duration, ducking_engaged, warnings, elapsed_ms и структурированным receipt.

Аудиограмма + план отметок глав (TE.4)

Применяет 3D-пространственное позиционирование звука.

Извлекает данные формы волны аудио (пики и участки тишины). Аргументы: input_path: Абсолютный путь к входному видео/аудио файлу. bins: Количество временных сегментов для анализа (по умолчанию 50).

Автоматически определяет смену сцен и создаёт главы. Анализирует видео на наличие склеек сцен и возвращает временные метки глав. Args: input_path: Абсолютный путь к входному видео. threshold: Порог обнаружения сцен от 0 до 1. По умолчанию 0.3. Returns: Список временных меток глав в формате (временная метка, описание).

Применить одну и ту же операцию к нескольким видеофайлам. Аргументы: inputs: Список абсолютных путей к входным видеофайлам. operation: Операция (trim, resize, convert, filter, blur, color_grade, watermark, speed, fade, normalize_audio). params: Параметры для операции. output_dir: Директория для выходных файлов. Автоматически генерируется, если опущено.

Запускает набор тестов AI-video benchmark для оценки возможностей хоста.

Заменяет видео, сохраняя утверждённый аудио, с явной политикой длительности.

Сохраняет или загружает JSON бренд-кита / профиля стиля.

Проверяет возможности хоста (ffmpeg, whisper, c2pa) и возвращает отчёт о возможностях.

Удаляет сплошной цветной фон (зеленый экран / хромакей). Аргументы: input_path: Абсолютный путь к входному видео. color: Цвет, который нужно сделать прозрачным, в шестнадцатеричном формате (по умолчанию зеленый: 0x00FF00). similarity: Насколько близкими должны быть цвета, чтобы быть удаленными (0.0-1.0, по умолчанию 0.01). blend: Степень смешивания удаленного цвета (по умолчанию 0.0). output_path: Путь для сохранения результата. Создается автоматически, если не указан.

Удаляет промежуточные видеофайлы после рабочего процесса. Полезно для многоэтапных пайплайнов, которые оставляют временные результаты. Файлы из keep сохраняются, даже если они указаны в files. Args: files: Список абсолютных путей для удаления. keep: Список абсолютных путей для сохранения (опционально).

Сравнивает качество видео между оригинальной и обработанной версиями. Аргументы: original_path: Абсолютный путь к оригинальному/эталонному видео. distorted_path: Абсолютный путь к обработанному/искажённому видео. metrics: Метрики для вычисления (по умолчанию: ['psnr', 'ssim']).

Собирает упорядоченные слои изображений/видео из JSON-спецификации. Поддерживаются обычное альфа-смешивание, непрозрачность, позиционирование по X/Y, преобразование (масштаб/ширина/высота), временные окна, опциональные альфа-источники маски/матовости, слои видео/изображения/сплошные и детерминированный чек плана слоёв. Ненормальные режимы смешивания, поворот и маршрутизация эффектов по слоям намеренно отложены — пока они не смогут поддерживать предварительную проверку. Аргументы: spec_path: Путь к JSON-спецификации композитных слоёв. output_path: Опциональный путь для результирующего медиафайла. save_layer_plan: Опциональный JSON-путь для сохранения разрешённого плана слоёв. dry_run: Проверить и вывести план слоёв без рендеринга медиа.

Строит манифесты, выборки, композиции, предварительные просмотры и проверки с поддержкой источника.

Перекодирует существующее видео в другой контейнер или кодек, например mp4, webm, gif или mov. Используйте это для преобразования формата; используйте video_export для финальных пресетов доставки. Входное видео доступно только для чтения, и создаётся новый выходной файл.

Суммирует известные события затрат в USD по категориям для проекта.

Создаёт видео из последовательности изображений. Аргументы: images: Список абсолютных путей к файлам изображений (по порядку). output_path: Куда сохранить выходное видео. Создаётся автоматически, если не указан. fps: Кадров в секунду для выходного видео (по умолчанию 30).

Координирует проверенных локальных планировщиков или возвращает структурированное воздержание.

Обрезает существующее видео до прямоугольной области или центральной процентной обрезки и создаёт новый выходной файл. Исходное видео доступно только для чтения; x/y по умолчанию задают центральную обрезку, если опущены.

Рендерит соответствующий схеме файл Cutfile через механизм рабочих процессов (Track E).

Проверяет Cutfile или компилирует его из goal / platform (N1/N5).

Выполняет всесторонний анализ качества дизайна видео. Проверяет качество компоновки, типографики, цвета, движения и композиции. Автоматически исправляет проблемы, когда это возможно. Аргументы: input_path: Абсолютный путь к видеофайлу auto_fix: Если True, автоматически применяет исправления strict: Если True, обрабатывает предупреждения как ошибки

Обнаруживает изменения сцен в видео. Аргументы: input_path: Абсолютный путь к входному видео. threshold: Чувствительность обнаружения сцен (0.0-1.0, меньшее значение = выше чувствительность, по умолчанию 0.3). min_scene_duration: Минимальная длительность сцены в секундах (по умолчанию 1.0).

Local TTS dub plan ES-first (P4.4) — планировать только до настройки бэкенда.

Накладывает фоновую музыку на голос в видео с автоматическим приглушением. Собственный звук видео (голос/диалог) управляет боковым компрессором FFmpeg: музыка затихает, пока звучит речь, и возвращается в паузах — стандартный приём для шортсов, рилсов и фрагментов подкастов. Аргументы: input_path: Видео, чей звук управляет приглушением. music_path: Фоновая музыка или эмбиент, который накладывается снизу. output_path: Куда сохранить результат. Создаётся автоматически, если не указан. music_volume: Базовый уровень музыки до приглушения (0–2, по умолчанию 0.6). threshold: Уровень бокового канала, при котором включается приглушение (0–1). ratio: Коэффициент сжатия, пока звучит голос (1–20). attack: Как быстро музыка затихает, в миллисекундах (1–2000). release: Как быстро музыка восстанавливается, в миллисекундах (1–9000).

Выполняет полное редактирование на основе временной шкалы из JSON-спецификации. JSON временной шкалы описывает видеоклипы, аудиодорожки, текстовые наложения, наложения изображений, переходы и настройки экспорта за одну операцию. Наложения изображений применяются за один проход фильтрграфа (без множественных перекодирований). Сокращенная последовательность (простая цепочка из нескольких клипов с переходами на границах):: { "clips": ["a.mp4", "b.mp4", "c.mp4"], "transitions": ["fade", "dissolve"], "transition_duration": 0.5 } Аргументы: timeline: Полный JSON временной шкалы (width/height/tracks/export) или сокращенная последовательность выше. Также может быть строкой JSON или путем к .json файлу. Наложения изображений в дорожках: {"type": "image", "images": [{"source": "logo.png", "position": "top-right", "width": 200, "opacity": 0.8}]} output_path: Куда сохранить итоговое видео. Генерируется автоматически, если не указан.

Сеанс диалогового редактирования. Шаг с input_path измеряет реальный QC (N6).

Оценка локального времени выполнения и стоимости единицы в режиме пробного запуска (не облачные расценки).

Перекодирует существующее видео для финальной доставки, используя пресет качества и выходной формат. Используйте это для рендеров, готовых к публикации; используйте video_convert, когда основная цель — преобразование контейнера/кодека. Исходное видео доступно только для чтения, и создаётся новый выходной файл.

Экспортирует кадры из видео в виде отдельных изображений. Аргументы: input_path: Абсолютный путь к входному видео. output_dir: Директория для извлечённых кадров. Создаётся автоматически, если не указана. fps: Количество кадров в секунду для извлечения (1.0 = 1 кадр в секунду, по умолчанию 1.0). format: Формат выходного изображения (jpg или png, по умолчанию jpg).

Извлекает аудиодорожку из видеофайла. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Куда сохранить аудиофайл. Автоматически генерируется, если не указан. format: Аудиоформат (mp3, aac, wav, ogg, flac).

Извлекает один кадр из видео для визуальной проверки. Аргументы: input_path: Абсолютный путь к видео. timestamp: Время в секундах, на котором извлечь кадр. output_path: Куда сохранить кадр. Автоматически генерируется, если не указан.

Добавляет эффекты появления и/или затухания на существующее видео без изменения исходного файла. Используйте fade_in для появления из чёрного в начале и fade_out для затухания до чёрного в конце; output_path создаётся или перезаписывается.

Применяет визуальный фильтр к видео. Стандартные пресеты: - blur: params={"radius": 5, "strength": 1} - color_preset: params={"preset": "warm"} (warm, cool, vintage, cinematic, noir) Аргументы: input_path: Абсолютный путь к входному видео. filter_type: Тип фильтра (blur, sharpen, brightness, contrast, saturation, grayscale, sepia, invert, vignette, color_preset, denoise, deinterlace, ken_burns, reverb, compressor, pitch_shift, noise_reduction). params: Необязательные параметры фильтра (например, radius для blur, preset для color_preset). output_path: Куда сохранить результат. Если не указан, генерируется автоматически. crf: Переопределяет значение CRF (0-51, чем ниже, тем лучше качество). По умолчанию 23. preset: Переопределяет пресет кодирования FFmpeg (ultrafast, fast, medium, slow, veryslow). По умолчанию medium.

Сохраняет или запрашивает локальный семантический индекс, привязанный к версии.

Автоматически исправляет проблемы дизайна в видео. Применяет автоматические исправления для проблем яркости, контрастности, насыщенности и уровня звука. Args: input_path: Абсолютный путь к входному видео output_path: Абсолютный путь для выходного файла (создается автоматически, если не указан)

Генерирует субтитры SRT из текстовых записей и по желанию встраивает их в видео. Args: entries: Список записей субтитров с ключами: start (float), end (float), text (str). input_path: Абсолютный путь к входному видео. burn: Если True, встраивает субтитры в видео (по умолчанию False).

Генеративный план последней мили с ограничениями расходов (P4.1) - только план. Платные провайдеры требуют max_spend_usd > 0 и оценку ≤ лимита. Используйте assert_generative_executable (множители) перед любым вводом-выводом провайдера.

Сегментирует видео в формат HLS (HTTP Live Streaming). Аргументы: input_path: Абсолютный путь к входному видео. output_dir: Директория для сохранения сегментов. Создаётся автоматически, если не указана. segment_duration: Целевая длительность сегмента в секундах (по умолчанию 4). playlist_name: Имя основного файла плейлиста. qualities: Список уровней качества (например, ["low", "medium", "high"]).

Миниатюра + заголовок-крючок: кандидаты для выбора человеком (TE.2)

Анализирует видеофайл для получения метаданных. Возвращает JSON {success, info:{duration, resolution, codec, fps, size, ...}}. Используйте перед любым редактированием, чтобы узнать размеры и длину исходного файла. Передайте input_path как абсолютный путь к существующему видеофайлу. Аргументы: input_path: Абсолютный путь к видеофайлу.

Получает расширенные метаданные видео. Возвращает подробную информацию о видео, включая определение смены сцены и доминирующие цвета. Аргументы: input_path: Абсолютный путь к входному видео. Возвращает: Dict с длительностью, fps, разрешением, битрейтом, has_audio, scene_changes.

Загружает неизменяемые байты исходного кода в существующий или новый приватный проект.

Создаёт структуру локального каталога проекта Kinocut (media/out/receipts + необязательный Cutfile)

Создает и сохраняет полный детерминированный временной пакет доказательств.

Направляет семантический глагол намерения в план (не выполняет скрытую модификацию медиа). Необязательный goal компилирует просматриваемый cutfile (N1) без рендеринга.

Честное поповерхностное языковое покрытие для транскрибирования, перевода и дубляжа.

Создаёт сеточную раскладку для нескольких видео. Размещает несколько видео в виде сетки (2x2, 3x1 и т.д.). Аргументы: clips: Список абсолютных путей к видеофайлам. layout: Раскладка сетки (2x2, 3x1, 1x3, 2x3). output_path: Абсолютный путь для выходного видео. gap: Пиксели между клипами. По умолчанию 10. padding: Отступ вокруг сетки. По умолчанию 20. background: Цвет фона в hex. По умолчанию #141414. Возвращает: Словарь со статусом успеха и output_path.

Наложение «картинка в картинке». Накладывает меньшее видео поверх основного видео. Аргументы: main_path: Абсолютный путь к основному видео. pip_path: Абсолютный путь к дополнительному видео (картинка в картинке). output_path: Абсолютный путь для выходного видео. position: Положение (top-left, top-right, bottom-left, bottom-right). По умолчанию bottom-right. size: Размер PIP как доля от основного. По умолчанию 0.25. margin: Отступ от краёв в пикселях. По умолчанию 20. border: Добавляет рамку вокруг PIP. По умолчанию true. border_color: Шестнадцатеричный код цвета рамки. По умолчанию #CCFF00. border_width: Ширина рамки в пикселях. По умолчанию 2. rounded_corners: Применяет скруглённые углы к PIP. По умолчанию true. Возвращает: Словарь с признаком успеха и путём к выходному видео.

Формирует отчёт об обучении (вердикты, дефекты, затраты, рецепты) из записей.

Маскирует тёмные области на основе яркости (светимости). Аргументы: input_path: Абсолютный путь к входному видео. threshold: Порог яркости (0.0-1.0). Пиксели темнее этого значения становятся прозрачными. output_path: Куда сохранить результат. Автоматически генерируется, если не указан.

Соединяет два или более существующих видеоклипа в один результирующий выходной файл. Входные клипы доступны только для чтения и остаются без изменений; инструмент создает выходной файл с автоматическим именем или записывает в output_path, используя FFmpeg и сообщая об ошибках проверки переходов или несоответствия медиа.

Нижняя граница офлайн-метрики (длительность/чёрный/громкость) — fail-closed, без фиктивных значений.

Создаёт анимированное видео счётчика чисел. Создаёт отдельное видео анимированного счётчика чисел. Аргументы: start: Начальное число. end: Конечное число. duration: Длительность анимации в секундах. output_path: Абсолютный путь для выходного видео. style: Необязательный словарь стиля с параметрами font, size, color, glow. fps: Частота кадров. По умолчанию 30. Возвращает: Словарь с статусом успеха и output_path.

Генерирует анимацию индикатора выполнения / загрузки. Создает автономное видео с анимацией прогресса. Аргументы: duration: Продолжительность анимации в секундах. output_path: Абсолютный путь для выходного видео. style: Стиль прогресса (bar, circle, dots). По умолчанию bar. color: Шестнадцатеричный код цвета прогресса. По умолчанию #CCFF00. track_color: Шестнадцатеричный код цвета фоновой дорожки. По умолчанию #333333. fps: Частота кадров. По умолчанию 30. Возвращает: Словарь со статусом успеха и output_path.

Нормализует громкость аудио до заданного уровня LUFS. Распространённые пресеты: -16 (YouTube), -23 (EBU R128/вещание), -14 (Apple/Spotify). Аргументы: input_path: Абсолютный путь к входному видео. target_lufs: Целевая интегральная громкость в LUFS (по умолчанию -16 для YouTube). output_path: Куда сохранить результат. Создаётся автоматически, если не указан.

Экспортирует Timeline IR в упрощённый OTIO JSON (P4.2).

Импортирует упрощённый OTIO JSON в Timeline IR (P4.2).

Картинка в картинке: накладывает одно видео поверх другого. Аргументы: background_path: Абсолютный путь к фоновому видео. overlay_path: Абсолютный путь к накладываемому видео. position: Положение на экране. Именованное (top-left и т.д.), в пикселях {"x": 100, "y": 50} или в процентах {"x_pct": 0.5, "y_pct": 0.5}. width: Ширина, до которой масштабируется наложение (в пикселях). height: Высота, до которой масштабируется наложение (в пикселях). opacity: Непрозрачность наложения (от 0.0 до 1.0). start_time: Время появления наложения (в секундах). duration: Продолжительность видимости наложения (в секундах). output_path: Путь для сохранения результата. Автоматически генерируется, если не указан. crf: Переопределяет значение CRF (0-51, чем меньше, тем выше качество). По умолчанию 23. preset: Переопределяет пресет кодирования FFmpeg (ultrafast, fast, medium, slow, veryslow).

Запускает унифицированную техническую, громкостную, цветовую и декодирующую предварительную проверку.

Генерирует быстрое низкоразрешенное превью для быстрого просмотра. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Путь для сохранения превью. Генерируется автоматически, если не указан. scale_factor: Коэффициент уменьшения (4 = 1/4 разрешения).

Создай каркас кинематографического видеопроекта с папками style, storyboard и refs. Аргументы: slug: Слаг проекта из строчных букв, цифр, дефисов или подчёркиваний. output_dir: Базовая директория для папки projects/. По умолчанию — текущая рабочая директория.

Экспортирует проверенную версию правки в виде переносимого рецепта без пути.

Воспроизводит переносимый рецепт в новую долговечную версию проекта.

Предложения вставок b-roll, привязанные к транскрипту — требуется проверка человеком, никогда не вставлять без звука.

Сопоставляет результаты контроля качества с типизированными предлагаемыми мутациями (только для ручного применения).

Оценивает шлюз публикации с блокировкой при отказе; любая блокирующая находка блокирует публикацию.

Проверяет спецификацию публикации. solve=True также выводит cutfile (N5).

Автоматический план наезда на точках разреза (TE.5)

Эвристики повествования/удержания, включая окно первых 15 секунд (P3.4).

Vision QC third — корректная работа при недоступности VLM (P3.3)

Запускает проверки визуального качества видео. Анализирует яркость, контраст, насыщенность, уровни звука и цветовой баланс. Возвращает оценки качества и рекомендации. Аргументы: input_path: Абсолютный путь к видеофайлу fail_on_warning: Если True, воспринимает предупреждения как ошибки

Читает теги метаданных из видео- или аудиофайла. Аргументы: input_path: Абсолютный путь к видео- или аудиофайлу.

Захватывает рецепт рабочего процесса (writer); идемпотентен по каноническому дайджесту.

Создавай артефакты предпросмотра только после того, как видео пройдёт проверки качества. Используй это перед публикацией или добавлением других эффектов доработки. Инструмент выполняет жёсткую проверку качества, затем создаёт миниатюру и раскадровку для проверки человеком.

Планирует явный удаленный исходящий трафик и фиктивные квитанции адаптера без сетевого ввода-вывода.

Собери локальный пакет для перепрофилирования контента с манифестом и артефактами проверки.

Создаёт манифест локального перепрофилирования в режиме пробного запуска для ресурсов, готовых к загрузке на платформу.

Проверяет план восстановления или квитанцию и повторно проверяет целостность артефакта.

Анализирует одно локальное видео и возвращает план спасения, классифицированный по политикам. Планирование никогда не изменяет исходный материал и не создает готовое медиа. Оно фиксирует результаты, идентификаторы безопасного ремонта, рекомендации, недоступные и заблокированные работы, подтверждение локальных возможностей, предварительные просмотры и оценку выполнения.

Отображает одобренные безопасные исправления из проверенного плана восстановления. Идентификаторы одобрения должны указывать на безопасные исправления в этом точном неизменном плане. Рендерер завершается с ошибкой при устаревших входных данных, возможностях, политике, состоянии возобновления, отмене или ошибке проверки и никогда не продвигает неудачный вывод.

Изменяет размер видео или его соотношение сторон. Возвращает JSON {success, output_path}. Используется для подгонки видео под целевые размеры или заданное соотношение сторон. Передайте input_path как исходное видео (например, из video_info) и либо width/height, либо aspect_ratio для задания целевых параметров. Аргументы: input_path: Абсолютный путь к входному видео. width: Целевая ширина в пикселях. Используется вместе с height. height: Целевая высота в пикселях. Используется вместе с width. aspect_ratio: Заданное соотношение сторон (16:9, 9:16, 1:1, 4:3, 4:5, 21:9). Переопределяет width/height. quality: Пресет качества (low, medium, high, ultra). output_path: Куда сохранить результат. Если не указан, генерируется автоматически.

Планировать или оценивать доказательно-ограниченную локальную восстановительную работу.

Инвертирует воспроизведение видео и аудио для проигрывания задом наперед. Args: input_path: Абсолютный путь к входному видео. output_path: Куда сохранить результат. Автоматически генерируется, если опущено.

Фиксирует принятие/отклонение/исправление человеком. Принятие + одобрение EDL может выполнить рендеринг (N4).

Записывает решение о проверке человеком (автор); исправления заменяются по идентификатору записи.

Собирает пакет рецензии и выносит вердикт шлюза публикации для артефакта-кандидата.

Наблюдение защитным механизмом: выполнение офлайн-метрики нижней границы в рамках политики проверки.

Создаёт HTML-интерфейс для проверки человеком с горячей перезагрузкой (P4.3).

Поворачивает и/или переворачивает существующее видео и создаёт новый выходной файл. Поддерживает повороты на прямой угол, а также горизонтальное и вертикальное отражение; исходное видео не изменяется.

Создаёт один привязанный к линии производный элемент (salvage derivative) и новый слот для рецензирования.

Преобразование перемотки с точностью до кадра (TE.9)

Запрашивает локально семантические отрезки на основе исходного кода без выдумывания описаний.

Строит локальную семантическую временную шкалу с исходными временными метками из предоставленных данных анализа.

Применяет маску геометрической формы к видео. Аргументы: input_path: Абсолютный путь к входному видео. shape: Форма для применения: "circle", "rounded_rect" или "oval". output_path: Путь для сохранения результата. Генерируется автоматически, если не указан. feather: Радиус размытия краёв в пикселях (0 — чёткие края).

Создаёт новое видео с изменённой скоростью воспроизведения, оставляя исходное видео без изменений. Значения ниже 1.0 создают замедленное движение, а значения выше 1.0 — ускоренное; коэффициент проверяется на соответствие настроенным ограничениям скорости.

Размещает два видео рядом или друг под другом. Аргументы: left_path: Абсолютный путь к первому видео. right_path: Абсолютный путь ко второму видео. layout: Тип размещения (рядом или друг под другом). output_path: Путь для сохранения результата. Если не указан, генерируется автоматически.

Стабилизирует дрожащее видео с помощью анализа векторов движения. Аргументы: input_path: Абсолютный путь к входному видео. smoothing: Сила сглаживания (по умолчанию 15, чем выше, тем стабильнее). zooming: Процент масштабирования для избежания чёрных границ (по умолчанию 0). output_path: Куда сохранить результат. Автоматически генерируется, если не указан.

Извлекает ключевые кадры и создаёт сетку раскадровки для проверки человеком. Аргументы: input_path: Абсолютный путь к входному видео. output_dir: Директория для сохранения кадров. Создаётся автоматически, если опущен. frame_count: Количество ключевых кадров для извлечения.

Вживляет субтитры (SRT/VTT/authored ASS) в видео. Аргументы: input_path: Абсолютный путь к входному видео. subtitle_path: Абсолютный путь к файлу субтитров (.srt, .vtt или .ass). output_path: Куда сохранить результат. Автоматически генерируется, если опущен. style: Опциональный параметр force_style, применяемый к любому формату субтитров, включая authored ASS (например, "FontSize=24,PrimaryColour=&H00FFFFFF"). Опустите, чтобы сохранить собственный стиль и позиционирование файла authored ASS.

Встраивает субтитры из SRT/VTT с настраиваемым стилем. Включает файл субтитров в видео с настраиваемым внешним видом. Args: input_path: Абсолютный путь к входному видео. subtitles_path: Абсолютный путь к файлу SRT или VTT. output_path: Абсолютный путь для выходного видео. style: Необязательный словарь стиля с настройками шрифта, размера, цвета, контура и т.д. Returns: Словарь со статусом успеха и output_path.

Предварительно просматривает, что сделает видеош аблон до рендеринга. Анализирует шаблон и возвращает список операций, примерную длительность, разрешение и размер файла — без фактической обработки видео. Args: template: Название шаблона (tiktok, youtube-shorts, instagram-reel, youtube, instagram-post). input_path: Абсолютный путь к входному видео (необязательно; используется для оценки длительности). duration: Переопределить примерную длительность в секундах. caption: Текст подписи для шаблонов TikTok / Instagram Reel / Instagram Post. title: Текст заголовка для шаблонов YouTube Shorts / YouTube. music_path: Абсолютный путь к фоновой музыке. outro_path: Абсолютный путь к файлу аутро (только для шаблона YouTube).

Добавляет анимированный текст на видео. Накладывает текст с эффектами анимации (затухание, скольжение и т.д.). Аргументы: input_path: Абсолютный путь к входному видео. text: Отображаемый текст. output_path: Абсолютный путь для выходного видео. animation: Тип анимации (fade, slide-up, typewriter). По умолчанию fade. font: Гарнитура шрифта. По умолчанию Arial. size: Размер шрифта. По умолчанию 48. color: Цвет текста. По умолчанию white. position: Позиция текста. По умолчанию center. start: Время начала в секундах. По умолчанию 0. duration: Продолжительность отображения. По умолчанию 3.0. Возвращает: Словарь с состоянием успеха (success) и output_path.

Извлекает один кадр (миниатюру / захват кадра) из видео. Аргументы: input_path: Абсолютный путь к входному видео. timestamp: Время в секундах, на котором извлечь кадр. По умолчанию — 10% длительности видео. output_path: Куда сохранить изображение кадра. Автоматически генерируется, если не указан.

Планирует явные или обычные правки временной шкалы как проверяемый EDL и diff.

Проверяет Timeline IR и компилирует для рендеринга DAG (P3.0). Семантические временные шкалы (кадры/тишины/слова) также получают видимый агентом text (N2).

Переводит субтитры SRT с честной отчётностью о языковом покрытии (сначала EN→ES).

Обрезает видеоклип по времени начала и длительности. Возвращает JSON {success, output_path}, указывающий на готовый рендер. Используется, чтобы вырезать сегмент из более длинного видео. Передайте input_path как абсолютный путь к исходному видео (например, из video_info), start как временную метку, а duration или end для определения сегмента. Args: input_path: Абсолютный путь к входному видео. start: Временная метка начала (например, '00:02:15' или строка с секундами, например '10.5'). duration: Длительность сохраняемого фрагмента (например, '00:00:30' или '30'). Взаимоисключающе с end. end: Временная метка конца. Взаимоисключающе с duration. output_path: Куда сохранить обрезанное видео. Если не указан, генерируется автоматически. accurate: Кадрово-точный поиск (медленнее). По умолчанию False — используется быстрый поиск по входу, который может остановиться на ближайшем ключевом кадре.

Проверяет набор текстовых наложений на визуальные дефекты перед рендерингом. Проверяет: перекрытие текста, низкую контрастность, небезопасное позиционирование, чрезмерное количество последовательных наложений и отсутствие теней. Аргументы: overlays: Список спецификаций наложений с ключами: text, position, size, color, shadow (optional), start_time (optional), duration (optional). video_width: Ширина видео в пикселях. video_height: Высота видео в пикселях. background_color: Шестнадцатеричный цвет фона для проверки контрастности. Возвращает: dict со списком warnings и булевым значением clean.

Сохраняет точный анализ активов; утверждения требуют активного человеческого подтверждения.

Планирует анализ объекта/камеры, рефрейминг или стабилизацию с учетом бюджетов кадрирования.

Накладывает изображение водяного знака на существующее видео и создаёт новый выходной файл. Видео и изображение водяного знака предназначены только для чтения; output_path создаётся или перезаписывается. Поддерживает именованные, пиксельные и процентные позиции, а также прозрачность, отступы, CRF и управление пресетами.

Суммирует любой receipt, который генерирует этот проект, с проверкой целостности только для чтения. Читает workflow render receipt, dry-run артефакт workflow_plan или layer_plan receipt (устаревший v1 без поля receipt_kind, или v2) по пути receipt_path и возвращает НОРМАЛИЗОВАННЫЙ результат проверки: kind (выводится из поля tool, если receipt_kind отсутствует, согласно поддержке устаревшего формата), schema_version, tool, versions, сводку статусов (статусы по шагам, неудачный шаг + ошибка, если есть), отчёт о наличии хешей и целостности (какие записанные хеши исходников и выходных данных по-прежнему совпадают с байтами на диске СЕЙЧАС, повторная проверка только для чтения), outputs, warnings, состояние очистки, а также указатели для человеческой проверки и известные ограничения. Ничего не рендерится и не изменяется. Некорректный или нечитаемый receipt завершается ошибкой с invalid_workflow_receipt. Args: receipt_path: Абсолютный путь к JSON-файлу receipt для проверки. compare_path: Необязательный второй receipt; если указан, также возвращает разницу (diff) в формате N3.

Создаёт план без рендеринга для спецификации задания рабочего процесса агента. Сначала проверяет спецификацию (fail-closed), затем собирает артефакт плана сухого прогона БЕЗ рендеринга любых медиа: упорядоченный граф операций, результаты ffprobe для каждого источника (длительность/разрешение/кодек) и sha256 хеши содержимого, где существует исходный файл, объявленные выходные намерения, сводка расширения вариантов, версии инструментов + FFmpeg и предупреждения о проблемах времени выполнения, которые не являются структурными ошибками (например, исходный файл, который ещё не существует). Единственный записываемый файл — необязательный JSON плана по пути save_plan; пути внутри артефакта относительны к рабочему пространству. Передаёт variant для планирования одного именованного варианта пакета: план отражает ЭФФЕКТИВНЫЕ (после переопределения) шаги этого варианта, автоматически именованные выходные пути и записывает workflow.variant. Неизвестный вариант или некорректное переопределение завершается ошибкой (fail-closed)(invalid_workflow_variant). Возвращает артефакт плана при успехе. При структурно недопустимой спецификации завершается ошибкой (fail-closed) с конкретным кодом ошибки code (те же коды, что и video_workflow_validate). Аргументы: spec_path: Абсолютный путь к файлу спецификации задания рабочего процесса JSON. save_plan: Необязательный путь для записи артефакта плана в JSON. variant: Необязательный объявленный идентификатор варианта для планирования его эффективных шагов.

Выполняет задание рабочего процесса агента (job-spec) и возвращает подтверждение происхождения (provenance receipt). Сначала проверяет спецификацию (с закрытием при ошибке), затем выполняет каждую разрешённую операцию (probe|trim|resize|convert|merge|add_text|composite_layers) ПОСЛЕДОВАТЕЛЬНО в порядке, указанном в спецификации, через функции базового движка. Промежуточные результаты записываются в уникальный для этого вызова каталог @work; при успехе он очищается, при ошибке сохраняется. Финальные медиафайлы попадают на указанные пути @outputs. Варианты пакетной обработки: передайте variant=<id>, чтобы отобразить один объявленный вариант (его переопределения накладываются на общие шаги и выходы, а единственный путь @outputs автоматически получает имя с идентификатором варианта, так что N вариантов создают N различных выходов); полученный чек содержит workflow.variant. Передайте all_variants=True, чтобы по очереди отобразить КАЖДЫЙ объявленный вариант и вернуть сводку workflow_batch (по одному чеку на вариант, каждый в свой каталог @work); используйте save_receipt_dir, чтобы также записать каждый чек варианта в <dir>/<variant>.json. Параметры variant и all_variants взаимно исключают друг друга. Передайте keep_intermediates=True, чтобы сохранить промежуточные файлы @work даже при успехе (это фиксируется как политика очистки keep-intermediates). Передайте resume_receipt (предыдущий чек рендеринга от задания, завершившегося ошибкой с сохранёнными промежуточными файлами), чтобы ВОЗОБНОВИТЬ: текущий spec_hash должен совпадать с хешем из чека (иначе ошибка resume_spec_mismatch) И, для варианта, вариант из чека должен совпадать (иначе resume_variant_mismatch); каждый шаг, чей записанный статус — completed И чьи записанные хеши входных данных всё ещё совпадают И чей записанный выходной файл всё ещё существует и его хеш совпадает с записанным, ПРОПУСКАЕТСЯ; первый шаг, не прошедший любую проверку, и все последующие шаги выполняются заново. Возвращает чек рабочего процесса (receipt_kind: "workflow"), содержащий: версии инструмента и FFmpeg, хеш спецификации, информацию об исходных файлах и их хешах, статус каждого шага с реальными хешами sha256 каждого потреблённого входа и созданного выхода, манифест очистки и оговорку об области детерминизма. При первом…

Проверяет спецификацию задания агентского workflow без рендеринга медиа. Запускает структурный валидатор с принципом fail-closed для JSON-спецификации задания по пути spec_path: оп-белый список (probe|trim|resize|convert|merge|add_text|composite_layers), разрешение символических ссылок @ref (@sources.<id>, @work/<name>, @outputs.<id>), упорядочивание только по обратным ссылкам (шаг может ссылаться на outputs из строго более ранних шагов @work), интроспекция параметров каждой операции и безопасность путей в пределах рабочей области (абсолютные пути и выходы через ../ / симлинки завершаются закрытием с ошибкой). В случае успеха возвращает структурированный вердикт ({"valid": true, ...}). При любом структурном нарушении завершается с ошибкой (fail closed) с конкретным кодом ошибки code (invalid_workflow_spec, unknown_workflow_ref, unsupported_workflow_op, unsafe_workflow_source, invalid_workflow_params). Args: spec_path: Абсолютный путь к JSON-файлу спецификации задания workflow.

Записывает метаданные в видео/аудиофайл. Аргументы: input_path: Абсолютный путь к входному файлу. metadata: Словарь пар ключ-значение тегов (например {'title': 'My Video', 'artist': 'Me'}). output_path: Куда сохранить результат. Создаётся автоматически, если не указан.