API ВЕГА

Генерация AI видео

Генерация видео с помощью полного каталога видео-моделей RunComfy через один CLI — text-to-video, image-to-video и video-extend от Veo. Этот skill подбирает подходящую модель под запрос пользователя и включает документированные паттерны промптинга плюс точную команду runcomfy run для каждого случая.

runcomfy.com · Видео-модели · Документация CLI

На базе RunComfy CLI

1. Установка (подробности в skill runcomfy-cli)

npm i -g @runcomfy/cli # или: npx -y @runcomfy/cli --version

2. Вход в аккаунт

runcomfy login # или в CI: export RUNCOMFY_TOKEN=<token>


# 3. Генерация

runcomfy run //

--input '{"prompt": "..."}'

--output-dir ./out

Подробности CLI: skill runcomfy-cli.

Установка этого skill

npx skills add agentspace-so/runcomfy-agent-skills --skill ai-video-generation -g

Выбор подходящей модели под запрос пользователя

Text-to-video (t2v) — от новых к старым

HappyHorse 1.0 — happyhorse/happyhorse-1-0/text-to-video (по умолчанию)

В настоящее время №1 на Artificial Analysis Video Arena. Нативный синхронизированный звук генерируется в том же проходе (без отдельного этапа Foley). Нативный 1080p, до ~15с, сильная согласованность персонажа при смене планов. Подходит для: универсального t2v, рекламы со звуком, клипов для соцсетей, нарративов с сменой планов. Не подходит для: аудио-синхронизации губ под конкретный voiceover-файл MP3 — используйте Wan 2-7.

Kling 3.0 4K — kling/kling-3.0/4k/text-to-video

Последний Kling, вывод в 4K, сильная идентичность персонажа при смене планов, премиальный киноязык. Подходит для: основных планов, финальных 4K-монтажей, нарративов с сменой планов. Не подходит для: итераций с ограничением бюджета — переключитесь на Kling 2-6 Pro или Standard i2v.

Seedance v2 Pro — bytedance/seedance-v2/pro

Флагман ByteDance — мультимодальный (до 9 опорных изображений, 3 опорных видео, 3 опорных аудиодорожки), синхронизированный звук в том же проходе, кинематографическая отработка движения, соблюдение языка объективов. Подходит для: кинематографических рекламных кадров, композиций с множеством опорных сигналов (объект + сцена + аудио), анаморфных форматов 21:9. Не подходит для: простых задач «один промпт → клип» — избыточная мощность, медленнее.

Seedance v2 Fast — bytedance/seedance-v2/fast

Более быстрый вариант Seedance v2 Pro, те же мультимодальные возможности. Подходит для: итераций над композициями Seedance v2 перед финальным подтверждением на Pro. Не подходит для: финальной доставки основных планов.

Wan 2-7 — wan-ai/wan-2-7/text-to-video

Флагман с открытыми весами, поле audio_url для аудио-синхронизации губ, нативная интеграция с image-моделями Wan. Подходит для: диалоговых сцен, где губы должны синхронизироваться с конкретным voiceover-файлом; при требовании пайплайна с открытыми весами. Не подходит для: генерации звука в том же проходе (без входа MP3) — используйте HappyHorse 1.0.

Kling 2-6 Pro — kling/kling-2-6/pro/text-to-video

Предыдущее поколение Kling — всё ещё высокое качество при гораздо меньшей стоимости по сравнению с 3.0 4K. Подходит для: массового производства, когда 3.0 4K слишком дорог. Не подходит для: премиальных основных планов — используйте Kling 3.0 4K.

Seedance 1-5 Pro — bytedance/seedance-1-5/pro/text-to-video

Предыдущее поколение Seedance, дешевле. Подходит для: батчей со стабильной идентичностью на поколении 1-5; базовый вариант с ограничением бюджета. Не подходит для: новой работы — предпочтите Seedance v2 Pro или Fast.

Image-to-video (i2v) — от новых к старым

HappyHorse 1.0 I2V — happyhorse/happyhorse-1-0/image-to-video (по умолчанию)

Анимирует любой статичный кадр с встроенным звуком, описанным в промпте, сильное сохранение идентичности. Подходит для: анимации сгенерированного портрета или товарного кадра, вертикальных клипов для соцсетей, аудио, описанного в voiceover. Не подходит для: физически точного движения объектов — используйте Veo 3-1.

Veo 3-1 — google-deepmind/veo-3-1/image-to-video

Флагман Google — движение, учитывающее физику, сильная постоянность объекта («повернуть на 180 градусов» = 180°), интеграция с extend-video для более длинных клипов. Подходит для: вращения продуктов, физически точного движения, сцен, где должно сохраняться «никакого другого движения». Не подходит для: аудио-синхронизации диалогов — используйте Wan 2-7 или HappyHorse.

Veo 3-1 Fast — google-deepmind/veo-3-1/fast/image-to-video

Более быстрый вариант Veo 3-1. Подходит для: итераций над композициями Veo. Не подходит для: финальной доставки основных планов — используйте полный Veo 3-1.

Kling 3.0 4K I2V — kling/kling-3.0/4k/image-to-video

Идентичность персонажа при смене планов, вывод в 4K из статичного кадра. Подходит для: 4K-основных планов, нарративных монтажей с персонажем. Не подходит для: итераций с ограничением бюджета — переключитесь на Pro или Standard.

Kling 3.0 Pro I2V — kling/kling-3.0/pro/image-to-video

Качественный уровень Kling 3.0 по умолчанию. Подходит для: качественного i2v при умеренной стоимости. Не подходит для: финальной доставки в 4K.

Kling 3.0 Standard I2V — kling/kling-3.0/standard/image-to-video

Самый доступный уровень i2v в 3.0. Подходит для: концептов и черновиков на Kling 3.0. Не подходит для: финальной доставки.

Hailuo 2-3 Pro — minimax/hailuo-2-3/pro/image-to-video

Последний MiniMax Hailuo — естественное движение, сильный результат на реальных объектах. Подходит для: реалистичного движения реальных людей / реальных товаров. Не подходит для: стилизованных персонажей — используйте Kling или Dreamina.

Dreamina 3-0 Pro — bytedance/dreamina-3-0/pro/image-to-video

i2v от ByteDance Dreamina — ориентация на иллюстрации и стилизованных персонажей. Подходит для: анимации иллюстрированных героев, живописных статичных кадров. Не подходит для: фотореалистичного движения.

Seedance 1-0 Pro Fast — bytedance/seedance-1-0/pro/fast/image-to-video

Более старое поколение i2v от Seedance, доступное. Подходит для: бюджетных батчей i2v на Seedance. Не подходит для: новой работы — Seedance v2 Pro обладает большим потенциалом (t2v + i2v + мультимодальность).

Продление существующего видео — от новых к старым

Veo 3-1 Extend — google-deepmind/veo-3-1/extend-video

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

Veo 3-1 Fast Extend — google-deepmind/veo-3-1/fast/extend-video

Более быстрый вариант продления Veo. Подходит для: продления клипов Veo Fast на соответствующем уровне задержки.

Подробности по процедуре продления (подготовка входного видео, стратегия якорей по кадрам, цепочки продлений) — см. skill video-extend.


t2v Маршрут 1: HappyHorse 1.0 — по умолчанию

Модель: happyhorse/happyhorse-1-0/text-to-video Каталог: happyhorse-1-0

В настоящее время №1 на Artificial Analysis Video Arena — рекомендуемый по умолчанию вариант RunComfy для универсального t2v. Нативный синхронизированный звук генерируется в том же проходе (без отдельного этапа Foley).

Схема

ПолеТипОбязательноеПо умолчаниюПримечания
promptstringда—Объект в начале, опишите движение + сцену + звук в одном утверждении
durationintнет5Секунды. До ~15с
aspect_ratioenumнет16:916:9, 9:16, 1:1 — типичные
resolutionenumнет1080p720p, 1080p
seedintнет—Воспроизводимость

Вызов

runcomfy run happyhorse/happyhorse-1-0/text-to-video \
  --input '{
    "prompt": "A red kite tumbles across a windy beach at golden hour, kids chasing it laughing, surf in the background. Audio: wind, gulls, distant laughter.",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }' \
  --output-dir ./out

Советы по промптингу

  • Начинайте с объекта и одного главного действия. «Красный змей летит через пляж» — управляемое глаголом, а не набором прилагательных.

  • Описывайте звук прямо в промпте — "Audio: wind, gulls, distant laughter." HappyHorse генерирует звук в том же проходе.

  • Язык движения важнее визуальных существительных — «переворачивается», «парит», «чётко приходит в фокус» лучше, чем «выглядит красиво».

  • Множественные планы: описывайте переходы явно — «Затем камера переходит к…» — лидерская согласованность при смене планов на Arena.


t2v Маршрут 2: Wan 2-7 — открытое веса + аудио-синхронизация губ

Модель: wan-ai/wan-2-7/text-to-video Каталог: wan-2-7 · коллекция wan-models

Выбирайте Wan 2-7, когда у вас есть конкретный voiceover-файл или аудио диалога и вы хотите, чтобы губы объекта на экране синхронизировались с ним. Поле audio_url управляет движением губ.

Вызов

С аудио-синхронизацией губ:

runcomfy run wan-ai/wan-2-7/text-to-video \
  --input '{
    "prompt": "Studio portrait of a woman in her 30s speaking confidently to camera, soft window light.",
    "audio_url": "https://your-cdn.example/voiceover.mp3",
    "duration": 6
  }' \
  --output-dir ./out

Простой t2v (без звука):

runcomfy run wan-ai/wan-2-7/text-to-video \
  --input '{"prompt": "Drone shot over forest canopy at sunrise, soft fog drifting between trees"}' \
  --output-dir ./out

Советы по промптингу

  • Для синхронизации губ промпт описывает сцену + говорящего; аудиофайл управляет ртом. Не транскрибируйте аудио в промпт — это будет конфликтовать с аудиодорожкой.

  • Преимущество открытых весов: интегрируйте в экосистему Wan (варианты с дообучением через LoRA) при наличии.


t2v Маршрут 3: Seedance v2 — мультимодальный кинематографический

Модель: bytedance/seedance-v2/pro (или /fast) Каталог: seedance-v2 Pro · коллекция seedance

Выбирайте Seedance v2 Pro, когда пользователю нужна мультимодальная управляющая информация — до 9 опорных изображений, 3 опорных видео, 3 опорных аудиодорожек, синтезируемых в том же проходе с кинематографической отработкой движения.

Вызов

runcomfy run bytedance/seedance-v2/pro \
  --input '{
    "prompt": "Anamorphic 35mm shot — a vintage car drives down a coastal road at dusk, lens flares from oncoming headlights, cinematic color grade.",
    "duration": 10,
    "aspect_ratio": "21:9"
  }' \
  --output-dir ./out

Советы по промптингу

  • Язык объективов и плёнки учитывается — «35mm анаморфный», «малая ГРИП», «мягкая гало», «Kodak 5219» — всё воспринимается.

  • Множество опорных сигналов: описывайте роли явно — "объект из опорного изображения 1, настроение из опорного видео 2, музыка из опорного аудио 1".

  • Кинематографические глаголы движения: «слежущий план», «наезд», «отъезд», «смена фокуса».


i2v Маршрут A: HappyHorse 1.0 I2V — по умолчанию

Модель: happyhorse/happyhorse-1-0/image-to-video Каталог: happyhorse-1-0 i2v

Вызов

runcomfy run happyhorse/happyhorse-1-0/image-to-video \
  --input '{
    "image_url": "https://your-cdn.example/portrait.jpg",
    "prompt": "She turns her head slowly to look at the camera and smiles. Wind through her hair. Audio: gentle breeze.",
    "duration": 6,
    "aspect_ratio": "9:16"
  }' \
  --output-dir ./out

Советы по промптингу

  • Описывайте движение, а не сцену, которую уже показывает изображение. Изображение — это ваша сцена; промпт — это ваша режиссура.

  • Явно фиксируйте камеру — «Камера стоит на месте» предотвращает дрейф; «медленный наезд» задаёт намерение.

  • Звук в том же промпте, как в t2v Маршруте 1.


i2v Маршрут B: Veo 3-1 — флагман Google

Модель: google-deepmind/veo-3-1/image-to-video (или /fast/image-to-video) Каталог: veo-3-1 i2v · коллекция veo-3

Выбирайте Veo, когда важнее всего физика / реализм / постоянство объектов. Veo 3-1 поддерживает как клипы длительностью 8 секунд, так и более длинные через сопутствующий endpoint extend-video.

Вызов

runcomfy run google-deepmind/veo-3-1/image-to-video \
  --input '{
    "image_url": "https://your-cdn.example/product.jpg",
    "prompt": "The bottle slowly rotates 180 degrees on a marble surface, soft daylight, no other motion."
  }' \
  --output-dir ./out

Советы по промптингу

  • Veo учитывает физику — «bottle rotates 180 degrees» даёт ровно 180°.

  • Постоянство объектов сильно выражено — укажите «no other motion», и остальные элементы останутся неподвижными.

  • Для i2v с аудио используйте Маршрут A (HappyHorse) — путь Veo с аудио расположен в другом месте каталога.


i2v Маршрут C: Kling 3.0 — идентичность в нескольких планах, 4K

Модель: kling/kling-3.0/{4k,pro,standard}/image-to-video Каталог: коллекция kling

Три уровня — выбирайте по балансу качества и стоимости:

УровеньEndpointКогда
4Kkling/kling-3.0/4k/image-to-videoКлючевые кадры, финальная поставка в 4K
Prokling/kling-3.0/pro/image-to-videoПо умолчанию — высокое качество при меньшей стоимости
Standardkling/kling-3.0/standard/image-to-videoКонцептуализация, черновики

Вызов

runcomfy run kling/kling-3.0/pro/image-to-video \
  --input '{
    "image_url": "https://your-cdn.example/character.jpg",
    "prompt": "The character walks toward the camera, soft handheld feel, end on a medium close-up."
  }' \
  --output-dir ./out

Советы по промптингу

  • Согласованность между планами — опишите последовательность сцен («идёт к камере, затем переход на средний план крупно»), и Kling сохранит идентичность персонажа между планами.

  • Язык камеры: «handheld», «Steadicam push», «static tripod» — поддерживаются.


Другие модели в каталоге

EndpointКогда
minimax/hailuo-2-3/pro/image-to-video · /standard/image-to-videoMiniMax Hailuo — естественное движение, хорош для реальных объектов
bytedance/dreamina-3-0/pro/image-to-videoDreamina — акцент на иллюстративности / концепт-арте
bytedance/seedance-1-0/pro/fast/image-to-videoSeedance 1-0 — более доступный вариант
kling/kling-video-o1/standardKling Video O1 — видео модель в стиле рассуждений
kling/kling-2-6/motion-control-proПеренос движения с референсного видео на целевого персонажа

Схемы расположены на странице каждой модели — передавайте набор полей через CLI без изменений.


Общие паттерны

Вертикаль для соцсетей (TikTok / Reels)

  • HappyHorse 1.0 i2v с aspect_ratio: "9:16", duration: 6, аудио описанным в том же промпте

Вращение продуктового бренда

  • Veo 3-1 i2v с "rotates 180 degrees, no other motion" — Veo учитывает физику

Кинематографичный рекламный кадр

  • Seedance v2 Pro с соотношением сторон 21:9, язык объективов и цветокоррекции в промпте

Персонажная история в нескольких планах

  • Kling 3.0 Pro i2v — опишите сцены («заходит → крупный план → смотрит на зрителя»)

Lip-sync для диалога

  • Wan 2-7 с audio_url, указывающим на ваш MP3-закадровый голос

Продление / продолжение существующего видео

Говорящая голова / аватар

  • См. skill ai-avatar-video для композиции OmniHuman + HappyHorse + Wan

Просмотр полного каталога


Коды выхода

КодЗначение
0успешно
64неверные аргументы CLI
65неверный входной JSON / несоответствие схемы
69ошибка 5xx на стороне upstream
75можно повторить: таймаут / 429
77не авторизован или токен отклонён

Полная справка: docs.runcomfy.com/cli/troubleshooting.

Как это работает

Skill классифицирует запрос пользователя в один из маршрутов t2v / i2v / extend, указанных выше, и вызывает runcomfy run <model_id> с соответствующим JSON-телом. CLI отправляет POST-запрос в RunComfy Model API, опрашивает статус запроса, получает результат и скачивает любые URL .runcomfy.net / .runcomfy.com в --output-dir. Ctrl-C отменяет удалённый запрос перед выходом.

Безопасность и конфиденциальность

  • Устанавливайте только через проверенный пакетный менеджер. Используйте npm i -g @runcomfy/cli или npx -y @runcomfy/cli. Agent не должен подставлять произвольный скрипт удалённой установки в shell от имени пользователя.

  • Хранение токена: runcomfy login записывает API-токен в ~/.config/runcomfy/token.json с правами 0600. Задайте переменную окружения RUNCOMFY_TOKEN для обхода файла в CI / контейнерах. Никогда не выводите токен в промпт, не записывайте в логи и не коммитьте.

  • Граница ввода (инъекция в shell): промпты передаются как JSON-строка через --input. CLI не расширяет содержимое промпта средствами shell. Нет поверхности для shell-инъекции через содержимое промпта.

  • Непрямая инъекция промпта (сторонний контент): URL референсных изображений / аудио / видео ненадёжны и могут повлиять на генерацию через встроенные инструкции (например, текст, вписанный в изображение, скрытый EXIF, управление через содержимое аудио). Меры со стороны agent:

Загружайте только URL, которые пользователь явно предоставил для этой задачи.

  • Если генерация расходится с промптом — подозревайте референсный файл, а не промпт.

  • Исходящие endpoint'ы (allowlist): только model-api.runcomfy.net и *.runcomfy.net / *.runcomfy.com. Без телеметрии, без callback'ов.

  • Ограничение размера сгенерированных файлов: CLI прерывает любую загрузку файла свыше 2 GiB.

  • Область использования bash: объявлено allowed-tools: Bash(runcomfy *). Skill никогда не инструктирует agent запускать что-либо кроме runcomfy <subcommand> — строки установки — это разовая настройка оператором.

См. также

  • runcomfy-cli — базовый CLI, обнаружение схем, режимы опроса, скриптинг

  • ai-image-generation — sibling для text-to-image / image-to-image

  • ai-avatar-video — специалист по говорящей голове / lip-sync видео

  • image-to-video — оживление статичного изображения (маршрутизатор с упором на i2v)

  • video-edit — рестайл / motion-control / редактирование идентичности на существующем видео

  • video-extend — продолжение существующего клипа через Veo extend

  • lipsync · face-swap — узкие маршрутизаторы техник

Установка

npx skills add https://github.com/prime-skills/runcomfy-agent-skills --skill ai-video-generation