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


