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. Первая функция позволяет использовать видеообразец при постановке задачи агенту; для второй заявлено извлечение цветов, шрифтов и логотипа сайта с последующим применением к видео. Обещание работы с любым форматом в анонсе не подтверждает поддержку каждого файла, ссылки или сложного эффекта.
Подготовьте образец и задачу
Сценарий: сделать 15-секундный анонс своего продукта с темпом и композицией выбранного образца. Нужны разрешённый к использованию видеореференс, собственные факты и медиа, целевые пропорции и подключённый агент. Для первого опыта выберите короткий фрагмент с несколькими понятными сценами.
- Укажите, что именно взять из образца: длительности сцен, порядок появления текста, движение камеры или характер переходов. Текст, логотипы, музыку и кадры другого автора не переносите без соответствующих прав.
- Дайте агенту доступный образец и отдельно собственные материалы. Для файлов документация Studio описывает добавление через
@; подробный порядок выбора референса в новом режиме в прочитанных источниках не установлен. Если ссылка не открылась или файл не прочитан, остановитесь на этом шаге. Пересказ по названию ролика не заменяет его просмотр. - Сначала получите разбор референса по времени и план новой версии. Согласуйте, какие свойства повторяются, а какие меняются.
- После согласования соберите короткую версию и сравните её с образцом на началах сцен, переходах и финале. Исправляйте один параметр за раз, сохраняя уже принятые решения.
В официальном руководстве по воссозданию референсов рекомендуется фиксировать движение и временные отметки, затем давать точные целевые значения для правок. Текстовое описание не гарантирует точного визуального совпадения. Числовые оценки сходства из документации относятся к примерам разработчиков и здесь не используются как обещание результата.
Промпт:
Подготовь в HyperFrames Studio отдельный 15-секундный ролик о моём продукте, формат 9:16. Я передам видеореференс, адрес сайта, утверждённый текст и свои медиа следующим сообщением.
Сначала проверь, что референс действительно доступен и его можно просмотреть. Если нет, сообщи точную причину и не выдумывай его содержание. Если доступен, разбери его по временным отметкам: структура сцен, темп, появление текста, движение и переходы. Предложи, какие приёмы подходят для моего материала.
Используй только мои факты и разрешённые материалы. Чужие логотипы, текст, музыку и кадры не копируй. До сборки покажи план сцен и дождись согласования. Исходные проекты не перезаписывай, платные генерации без разрешения не запускай.
После согласования собери редактируемый проект. Проверь читаемость русского текста, переходы и финальный кадр. Укажи, что удалось перенести из референса, где пришлось упростить и какие проверки выполнены. Финальный MP4 экспортируй после просмотра и правок.Признак успеха: новый проект содержит ваши материалы и согласованные приёмы референса; русский текст читается, а экспорт проходит проверки из раздела ниже. Если образец зависит от сложной съёмки или эффекта, воспроизведение которого не подтверждено, начните с одной сцены и оцените её до сборки всего ролика.
Фирменное оформление сайта и Brand kits
Сценарий: подготовить несколько анонсов с одинаковыми цветами, шрифтами и логотипом. На входе нужны доступный сайт либо утверждённое руководство по стилю и разрешённые файлы. По анонсу Brand kits извлекает оформление сайта; правильность результата нужно проверить до создания серии.
Документация по фирменному оформлению рекомендует задавать конкретный источник: сайт, файл frame.md, руководство по стилю или материалы Figma. В frame.md можно закрепить точные цвета, семейства шрифтов и правила оформления. Подключение конкретного Brand kit к такому файлу в прочитанных источниках не описано; это отдельный документированный способ передать агенту оформление.
- Передайте адрес сайта и исходные файлы логотипа и шрифтов, если они есть. Попросите показать найденные значения и их источники до сборки.
- Проверьте цвета, версию логотипа, наличие кириллицы в выбранном шрифте и право использовать файлы. Автоматическое извлечение не подтверждает лицензию.
- Зафиксируйте принятые правила в проекте и используйте их при постановке задачи сразу. Размер текста и расположение элементов адаптируйте под видео: размеры веб-страницы могут оказаться нечитаемыми в кадре.
- Соберите одну короткую пробу. После просмотра используйте согласованную основу для следующих роликов, меняя только содержание.
Промпт:
Подготовь фирменное оформление для серии роликов 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


