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

Руководство рассчитано на тех, кто уже работает с кодинг-агентом и может выполнить команды в терминале. Оно поможет установить приложение на Mac, открыть проект из Codex и пройти путь до MP4. Проверено 6 октября 2026 года: настольное приложение 0.1.0, командная строка HyperFrames 0.8.134. Дополнено 7 октября по официальной подборке девяти приёмов Studio, опубликованной 6 октября. Разработчики не указали в ней отдельную версию приложения или дату появления каждой функции. Дополнено 16 октября 2026 года: работа с видеореференсами, фирменным оформлением сайта и подключением агента по актуальным официальным источникам. Новые сценарии проверены по документации и анонсу, без запуска в приложении; версия настольной сборки с новыми функциями в анонсе не указана. Прежний практический тест и закреплённые ниже команды CLI относятся к версиям от 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 из «Программ». В нашем тесте установщик поместил приложение в эту папку, после чего оно открыло локальный проект.

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

Для работы через встроенный чат актуальная документация приложения предусматривает вход через Continue with HeyGen. Отдельно подключите Claude Code или Codex: откройте Settings → Agent либо переключатель агента в заголовке чата. Для уже установленного и авторизованного Codex нажмите Check again и дождитесь состояния Ready. Если агент отсутствует или не выполнен вход, следуйте шагам официального руководства по подключению. Учётная запись HeyGen и вход в выбранного агента выполняют разные роли. Запросы агента учитываются в плане его аккаунта; вариант оплаты через API-ключ настраивается отдельно. Этот способ подключения описан разработчиками и в новом практическом тесте здесь не проверялся.

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.

Видео по референсу: структура, темп и свои материалы

15 октября 2026 года разработчики анонсировали «Reference Any Video» и Brand kits. Первая функция позволяет использовать видеообразец при постановке задачи агенту; для второй заявлено извлечение цветов, шрифтов и логотипа сайта с последующим применением к видео. Обещание работы с любым форматом в анонсе не подтверждает поддержку каждого файла, ссылки или сложного эффекта.

📌
Граница проверки: точное расположение нового режима, поддерживаемые источники видео и минимальная версия приложения по прочитанным источникам не установлены. Следующий сценарий — редакционная последовательность работы на основе официальных рекомендаций, без заявления о выполненном тесте «Reference Any Video». Если функция отсутствует, проверьте Settings → Updates → Check for updates по инструкции разработчиков. Обновление не гарантирует появления функции в конкретной учётной записи.

Подготовьте образец и задачу

Сценарий: сделать 15-секундный анонс своего продукта с темпом и композицией выбранного образца. Нужны разрешённый к использованию видеореференс, собственные факты и медиа, целевые пропорции и подключённый агент. Для первого опыта выберите короткий фрагмент с несколькими понятными сценами.

  1. Укажите, что именно взять из образца: длительности сцен, порядок появления текста, движение камеры или характер переходов. Текст, логотипы, музыку и кадры другого автора не переносите без соответствующих прав.
  2. Дайте агенту доступный образец и отдельно собственные материалы. Для файлов документация Studio описывает добавление через @; подробный порядок выбора референса в новом режиме в прочитанных источниках не установлен. Если ссылка не открылась или файл не прочитан, остановитесь на этом шаге. Пересказ по названию ролика не заменяет его просмотр.
  3. Сначала получите разбор референса по времени и план новой версии. Согласуйте, какие свойства повторяются, а какие меняются.
  4. После согласования соберите короткую версию и сравните её с образцом на началах сцен, переходах и финале. Исправляйте один параметр за раз, сохраняя уже принятые решения.

В официальном руководстве по воссозданию референсов рекомендуется фиксировать движение и временные отметки, затем давать точные целевые значения для правок. Текстовое описание не гарантирует точного визуального совпадения. Числовые оценки сходства из документации относятся к примерам разработчиков и здесь не используются как обещание результата.

Промпт:

Подготовь в HyperFrames Studio отдельный 15-секундный ролик о моём продукте, формат 9:16. Я передам видеореференс, адрес сайта, утверждённый текст и свои медиа следующим сообщением.

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

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

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

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

Фирменное оформление сайта и Brand kits

Сценарий: подготовить несколько анонсов с одинаковыми цветами, шрифтами и логотипом. На входе нужны доступный сайт либо утверждённое руководство по стилю и разрешённые файлы. По анонсу Brand kits извлекает оформление сайта; правильность результата нужно проверить до создания серии.

Документация по фирменному оформлению рекомендует задавать конкретный источник: сайт, файл frame.md, руководство по стилю или материалы Figma. В frame.md можно закрепить точные цвета, семейства шрифтов и правила оформления. Подключение конкретного Brand kit к такому файлу в прочитанных источниках не описано; это отдельный документированный способ передать агенту оформление.

  1. Передайте адрес сайта и исходные файлы логотипа и шрифтов, если они есть. Попросите показать найденные значения и их источники до сборки.
  2. Проверьте цвета, версию логотипа, наличие кириллицы в выбранном шрифте и право использовать файлы. Автоматическое извлечение не подтверждает лицензию.
  3. Зафиксируйте принятые правила в проекте и используйте их при постановке задачи сразу. Размер текста и расположение элементов адаптируйте под видео: размеры веб-страницы могут оказаться нечитаемыми в кадре.
  4. Соберите одну короткую пробу. После просмотра используйте согласованную основу для следующих роликов, меняя только содержание.

Промпт:

Подготовь фирменное оформление для серии роликов HyperFrames. Адрес моего сайта и разрешённые файлы логотипа и шрифтов я передам следующим сообщением.

Сначала извлеки и покажи цвета с точными HEX-значениями, семейства шрифтов и выбранный логотип. Для каждого укажи источник. Не подменяй недоступные шрифты и логотип догадками. Проверь поддержку кириллицы; если данные извлечь нельзя, запроси недостающие файлы или значения.

После моего согласования сохрани правила оформления в frame.md в папке нового проекта. Создай 10-секундную пробу 9:16 с моим текстом и материалами. Сохрани точные цвета и выбранные шрифты, а размеры текста и композицию адаптируй для просмотра с телефона.

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

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

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

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

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

Задача: показать назначение продукта за полминуты. На входе нужны сайт, реальные изображения и один главный тезис. Агент предлагает сцены, собирает композицию и открывает её в 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