HyperFrames Studio — редактор, в котором человек и ИИ-агент работают с одним видеопроектом. Агент собирает сцены и анимацию, а вы смотрите результат на временной шкале, уточняете детали и проверяете готовый ролик.

Руководство рассчитано на тех, кто уже работает с кодинг-агентом и может выполнить команды в терминале. Оно поможет установить приложение на Mac, открыть проект из Codex и пройти путь до MP4. Проверено 6 октября 2026 года: настольное приложение 0.1.0, командная строка HyperFrames 0.8.134. Дополнено 7 октября по официальной подборке девяти приёмов Studio, опубликованной 6 октября. Разработчики не указали в ней отдельную версию приложения или дату появления каждой функции. Интерфейс развивается; доступность платформ проверяйте на странице загрузки Studio.

Studio, движок и агент: кто за что отвечает

HyperFrames — движок, который собирает видео из HTML, оформления, медиа и анимации. Его устройство разобрано в руководстве «HyperFrames от HeyGen — видео как код для ИИ-агентов и Codex».

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

ИИ-агент получает задачу, работает с файлами и выполняет проверки. Можно продолжать диалог в Codex и открывать результат в Studio. Встроенная панель агента — ещё один способ работы. В меню агента внутри чата Studio можно выбрать Claude Code и поручать ему сборку и правки прямо в приложении. Этот маршрут показан разработчиками; условия входа и оплаты модели нужно проверять отдельно.

В нашей проверке проект создавался из Codex. Studio использовалась для открытия и просмотра композиции; встроенному агенту команды не отправлялись. Поэтому ниже разделены проверенный маршрут и возможности, описанные разработчиками.

Что можно делать в редакторе

ЗадачаГде работатьЧто проверять после правки
Посмотреть сцену и переходКадр и временная шкалаНет ли пустого кадра или резкого скачка
Изменить текст, размер, положениеХолст, Layers и DesignЧитается ли текст и не закрывает ли соседние элементы
Разрезать, передвинуть или укоротить клипВременная шкалаСохранились ли звук и логика перехода
Заменить изображение или звукMedia и AssetsКадрирование, длительность, громкость
Указать проблему в кадре или на участке видеоРисунок или комментарий для агентаИсправлено ли указанное место без нежелательных изменений
Перестроить несколько сценДиалог с агентомСохранились ли факты, нужные материалы и финал
Получить готовое видеоРендер из Studio, агента или CLIВоспроизводится ли экспортированный файл целиком

Набор доступных свойств зависит от выбранного элемента. Для вложенной сцены иногда нужно открыть её отдельно; сложную правку удобнее передать агенту. Описания операций: редактирование кадра и работа со временем.

Официальная демонстрация HyperFrames Studio от HeyGen — 1 минута 21 секунда. Источник: сайт HyperFrames Studio

Установка на Mac и подготовка Codex

1. Установите приложение

Откройте официальную страницу HyperFrames Studio, скачайте установщик для macOS и выполните его шаги. Запустите HyperFrames из «Программ». В нашем тесте установщик поместил приложение в эту папку, после чего оно открыло локальный проект.

На момент проверки сайт также показывает загрузку для Linux и помечает Windows как Coming soon. Само руководство проверено на macOS; работу других сборок здесь не утверждаем.

2. Подготовьте локальный инструментальный набор

Для описанного ниже маршрута через командную строку нужны Node.js 22 или новее и FFmpeg. Если их нет, установите подходящие сборки с официальных сайтов. Проверьте доступность:

node --version
ffmpeg -version
npx hyperframes@0.8.134 doctor

Ожидаемый результат: обе программы запускаются, а диагностика HyperFrames не сообщает о недостающих обязательных зависимостях. Установка одного приложения и готовность отдельного CLI-маршрута — разные проверки.

3. Подключите навыки агента

Навыки объясняют агенту структуру композиции, работу с медиа и проверки перед экспортом. Для отдельной установки официальный проект рекомендует:

npx hyperframes@0.8.134 skills update

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

Номер 0.8.134 фиксирует версию CLI, проверенную в этом руководстве. Он не фиксирует навсегда содержимое навыков: команда их обновления получает актуальные материалы проекта.

Первый проект: от задания до просмотра

Выберите пустую рабочую папку и откройте её в Codex. Подготовьте адрес сайта либо свои изображения, короткий текст и музыку, которую можно использовать. Для первого опыта достаточно ролика на 10–15 секунд без озвучки.

Промпт:

Используй навык hyperframes и создай в этой папке 15-секундный ролик о моём проекте. Адрес сайта я укажу следующим сообщением. Формат 9:16, русский текст, крупные титры.

Возьми реальные изображения и факты с сайта. Сначала покажи идею и план сцен. После моего согласования собери редактируемый локальный проект и открой его в HyperFrames Studio. Платные генерации не запускай. Если своей музыки нет, сделай первую версию без звука.

Перед сдачей проверь композицию и сообщи путь к папке проекта. Финальный экспорт выполни после просмотра и правок.

Такой запрос задаёт результат и пределы расходов, оставляя агенту обычные технические решения. Для роликов по сайту предусмотрен рабочий процесс product-launch-video: он использует материалы страницы и превращает их в сцены. Доступность сайта и качество исходных изображений влияют на результат. Руководство по видео о продукте.

Когда агент сообщит папку проекта, перейдите в неё в терминале и откройте приложение:

npx hyperframes@0.8.134 open .

Эта команда проверена с установленной Studio на Mac. Точка означает текущую папку проекта. Если нужен браузерный просмотр, используйте:

npx hyperframes@0.8.134 preview

Уже существующий проект можно открыть и через интерфейс: импортируйте папку проекта HyperFrames в Studio и продолжайте работу. Это относится к исходникам проекта; готовый MP4 не заменяет такую папку. Импорт прошлых проектов.

Признак успеха: вы видите свой ролик, можете запустить воспроизведение и перейти к середине. Если показывается стартовый шаблон, сначала проверьте папку и наличие созданных сцен.

Как вносить правки без случайной анимации

Остановитесь на кадре, где проблема хорошо видна. Выберите элемент на холсте или через Layers. В Design измените одно нужное свойство: например, текст или положение. Затем просмотрите участок до и после изменения.

По документации, автоматическое создание ключевых кадров (Auto-keyframe) включено изначально. Для постоянного исправления расположения отключите его перед перемещением элемента. Если оставить режим включённым, изменение в текущей точке времени может стать частью анимации. Описание ключевых кадров при правке.

Для разрезания выберите клип на временной шкале и нажмите S — этот приём показан в официальной подборке. Перетаскивание тела клипа меняет момент его появления; перетаскивание края меняет временную границу. После сокращения сцены проверьте вход и выход элементов. Некоторые клипы нельзя безопасно разрезать: доступность операции зависит от их типа. Руководство по временной шкале.

Если меняется вся сцена или история ролика, сформулируйте правку агенту с точной привязкой ко времени.

Промпт:

В сцене с 5-й по 9-ю секунду заголовок закрывает изображение. Перестрой расположение: изображение должно остаться целиком, заголовок — читаться с телефона. Сохрани текст, длительность сцены и музыку. После изменения проверь весь переход, а не только один кадр.

Как показывать агенту, что именно изменить

В Studio есть два способа привязать замечание к изображению или времени. Они описаны в официальной подборке; в нашем практическом тесте эти функции не использовались.

Нарисуйте правку на кадре. Обведите проблемный элемент в предпросмотре, добавьте короткую заметку и отправьте её агенту. Например: «Этот заголовок закрывает лицо — подними его выше, сохрани размер». Так проще указать конкретный объект, чем описывать его положение длинным сообщением. Рисунок для агента.

Оставьте комментарий в точке или на отрезке. Можно указать место на видео либо выделить протяжённый участок времени. Соберите замечания и отправьте их агенту вместе. Например, один комментарий — к мелкой подписи, другой — к слишком быстрому переходу. После обработки просмотрите все затронутые участки. Комментарии в Studio.

Рисунок помогает показать объект, комментарий на отрезке — объяснить проблему, которая проявляется во времени. В обоих случаях напишите желаемый результат и что важно сохранить: текст, музыку, длительность или соседние сцены.

Как передавать медиа и использовать прошлые проекты

Упоминание через @

В чате Studio введите @, выберите нужный медиафайл и объясните, где его использовать. Например, попросите поставить выбранное изображение во второй сцене вместо текущего. Такое упоминание связывает задачу с конкретным ресурсом. Упоминание медиа.

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

Эти действия относятся к интерфейсу Studio. Внешнему агенту в Codex по-прежнему можно передать путь к папке проекта и файлам.

Перетаскивание файла

Файл можно перетащить на временную шкалу, чтобы разместить его в нужный момент, либо в поле запроса, чтобы передать агенту. Выберите первый способ, если место уже известно; второй — если агент должен подобрать сцену и расположение. После добавления проверьте длительность, кадрирование и, для аудио, громкость. Drag and drop в Studio.

Полезные сценарии

Короткое видео о сайте или продукте

Задача: показать назначение продукта за полминуты. На входе нужны сайт, реальные изображения и один главный тезис. Агент предлагает сцены, собирает композицию и открывает её в Studio; вы проверяете содержание и вносите правки.

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

Второй формат для другой площадки

Задача: получить из принятого вертикального ролика горизонтальную версию для сайта или презентации. Передайте агенту исходный проект и попросите сохранить содержание и музыку, но заново расположить элементы в кадре 16:9.

При подготовке руководства так созданы две версии ролика pimenov.ai: 1080×1920 и 1920×1080, обе по 30 секунд при 30 кадрах в секунду. В горизонтальной версии переставлены элементы шести сцен. Текст, длительности и музыка сохранены; оба MP4 прошли полное декодирование без ошибок.

Пример pimenov.ai: горизонтальная версия ролика, созданного с Codex и HyperFrames. Формат 16:9, 1920×1080, 30 секунд.

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

Серия роликов с повторяющейся структурой

Задача: выпускать однотипные анонсы с новым заголовком, изображением и датой. Возьмите принятый проект как основу, сохраните копию и поручите агенту заменить только переменные данные. После замены проверьте самый длинный заголовок и все места появления даты.

Результат — новая версия с сохранённым оформлением. Сценарий подходит для повторяемой структуры; при другой истории или количестве сцен потребуется переработка композиции.

Экспорт и проверка готового MP4

В папке проекта запустите проверку, затем экспорт:

npx hyperframes@0.8.134 check
npx hyperframes@0.8.134 render --quality high --output renders/final.mp4

Исправьте ошибки проверки до финальной сборки. Затем откройте renders/final.mp4 и просмотрите его целиком со звуком. Успешный экспорт подтверждает создание файла, но оценку читаемости и содержания нужно выполнить отдельно. Завершение и экспорт проекта.

Перед использованием ролика проверьте:

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

Для технической проверки можно выполнить:

ffprobe -v error -show_entries format=duration:stream=codec_name,width,height,r_frame_rate -of json renders/final.mp4
ffmpeg -v error -i renders/final.mp4 -f null -

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

Расходы, доступ и ограничения

Локальный рендер HyperFrames не расходует кредиты HeyGen. При этом работа ИИ-агента, облачный рендер, синтез речи и генерация медиа могут оплачиваться отдельно. До запуска таких операций уточните сервис и бюджет. Условия локального и внешнего использования.

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

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

Studio требует проверки результата после правок. Для длинного съёмочного монтажа с большим количеством исходников сначала оцените удобство редактора на небольшом фрагменте. Наиболее понятная отправная точка — короткий ролик с титрами, графикой и управляемыми сценами.

Если что-то не работает

СимптомЧто проверитьПризнак исправления
Открывается пустой шаблонТекущую папку и созданные файлы проектаВ Studio видны нужные сцены
FFmpeg найден, но экспорт падаетЗапускается ли ffmpeg -version, нет ли ошибки библиотекиFFmpeg стартует, экспорт завершается
Медиасервис отвечает UnauthorizedДействительность входа именно в этот сервисЗапрос проходит либо проект использует готовый локальный файл
После перемещения текст неожиданно движетсяСостояние Auto-keyframeПостоянная правка остаётся постоянной при воспроизведении
В другом формате обрезаны элементыРаскладку сцен, размеры текста и изображенийВесь важный контент помещается в новый кадр

В нашем запуске один установленный FFmpeg не стартовал из-за отсутствующей динамической библиотеки. Для экспорта использовали другую уже работающую установку. Такой сбой относится к локальному окружению; его нельзя автоматически приписывать Studio.

Следующий шаг

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

Если в команде регулярно нужны продуктовые видео, начните с одного принятого шаблона и проверки полного цикла до готового файла.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov