Руководство по использованию
Создание коротких видео из изображений с помощью Wan2.7 через API HiAPI
Руководство для разработчиков: выбор первого кадра, подсказки для камеры и ритма, соотношение сторон, длительность и пакетная генерация
На этой странице
Почему image-to-video подходит для коротких видео
Короткие видео — это бизнес, где побеждает количество. Отдельный фрагмент редко бывает конечным результатом; настоящий результат — это серия фрагментов, разделяющих одинаковый внешний вид, одинаковый ритм и одинаковую частоту публикаций. Эта потребность влияет на выбор инструментов сильнее, чем любой отдельный показатель качества вывода.
Image-to-video идеально подходит для этого, потому что превращает статичный кадр в основной управляющий сигнал. Вместо того чтобы описывать всю сцену словами и надеяться, что модель случайно попадёт в задуманную композицию, вы передаёте модели уже одобренный кадр: субъект находится там, где вы его разместили, кадрирование — то, которое вы спроектировали, свет падает так, как вы его поставили. Этап генерации тогда сосредоточен на движении — как движется субъект, как движется камера, как быстро «дышит» камера, — а не на создании сцены с нуля.
Такое разделение важно для команды. Статичные кадры могут создаваться, проверяться и утверждаться людьми, разбирающимися в композиции, с использованием любого доступного конвейера. Движение — это меньшая и более удобная для тестирования задача. Когда конкретный фрагмент не удаётся, обычно можно определить, проблема в кадре или в подсказке, — и именно это бинарное разделение вы хотите при производстве десятков фрагментов в неделю.
Сквозной конвейер в HiAPI намеренно остаётся скучным:
- Создайте или выберите статичный первый кадр для каждого плана.
- Напишите подсказку для камеры, описывающую действие субъекта, движение камеры и ритм.
- Отправьте статичный кадр и подсказку с фиксированными соотношением сторон и длительностью на маршрут
wan2.7-video/image-to-video. - Соберите возвращённые фрагменты в очередь проверки.
- Примите, переформулируйте подсказку или перекомпонуйте кадр, затем опубликуйте.
Всё в этом руководстве посвящено тому, чтобы каждый из этих шагов был воспроизводимым, потому что ценность конвейера коротких видео — не в одном блестящем фрагменте, а в возможности завтра прогнать тот же процесс с новыми кадрами и получить сопоставимые результаты.
Статичный кадр как единица работы
Относитесь к статичному кадру как к артефакту, которым вы управляете версиями. На практике это означает детерминированное именование кадров и хранение утверждённых кадров вместе с подсказками, которые с ними используются. Если позже вы захотите попробовать другой вариант для того же плана, меняйте только одну переменную за раз: подсказку или кадр, но никогда обе одновременно.
Что модель решает за вас, а что нет
Соотношение сторон и длительность устанавливаете вы, а не подсказка. Зафиксируйте их как можно раньше. Всё нижестоящее — то, как вы компонуете статичный кадр, как формулируете ритм, как монтируете фрагмент для платформы, — предполагает, что эти два значения уже зафиксированы.

Выбор первого кадра
Первый кадр берёт на себя большую часть работы. Если первый кадр выбран неправильно, никакая настройка подсказки не спасёт фрагмент полностью, и вы потратите много итераций на погоню за проблемой, которая на самом деле в статичном кадре. Прежде чем тратить любую генерацию, отфильтруйте кандидатов с помощью короткого явного чек-листа.
Композиция и кадрирование субъекта
Выбранный кадр должен быть скомпонован для того соотношения сторон, которое вы доставляете, а не просто обрезан до него. Если субъект в статичном кадре находится близко к краю, ожидайте, что у модели почти не будет пространства для движения камеры без выталкивания субъекта из кадра. Оставьте место для движения: пространство для отвода взгляда в направлении предполагаемой панорамы, пространство над субъектом, который может подниматься, передние планы, способные создавать параллакс.
Проверяйте кадрирование в целевом соотношении сторон, а не в исходном. Кадр, который выглядит сбалансированным как квадрат, может потерять субъекта, когда его втискивают в высокий вертикальный формат.
Пространство над головой и согласованность кадрирования
Если一批 фрагментов будут монтироваться вместе или публиковаться последовательно, сохраняйте одинаковое пространство над головой между кадрами. Несогласованное пространство над головой читается как небрежный монтаж, даже если каждый отдельный фрагмент в порядке. Установите соглашение — например, фиксированный зазор от макушки субъекта до верхнего края кадра — и применяйте его к каждому статичному кадру в группе.
Направление света и стабильность теней
Освещение определяет, насколько правдоподобно выглядит движение. Сильный направленный свет и чёткие тени дают модели структуру, на которую можно опереться; плоский свет без теней часто производит движение, которое выглядит как скольжение, а не как перемещение. Отдавайте предпочтение кадрам с однозначным направлением света, избегайте статичных кадров, где тени могут падать в двух направлениях, — такая двусмысленность часто проявляется как мерцание.
Статика, ведущая к движению
Хороший первый кадр намекает на то, что произойдёт дальше. Субъект в процессе действия, взгляд за пределы кадра, тело, наклонённое к открытому пространству, — всё это даёт модели естественное направление продолжения. Идеально симметричные, фронтальные, неподвижные портреты труднее всего естественно анимировать, потому что у них нет подразумеваемого направления.
Чистота кадра
Перед генерацией проверьте статичный кадр в полном разрешении на наличие дефектов: размытие по краям, несогласованные руки, повторяющиеся текстуры, текст, который станет очевидно искажённым, как только начнётся движение. Мелкие дефекты в статичном кадре становятся очевидными дефектами во фрагменте. Исправить или перегенерировать кадр почти всегда дешевле, чем заново генерировать видео.

Написание подсказок для камеры и ритма
Самая распространённая ошибка в подсказках для image-to-video — писать подсказку как описание сцены. Сцена уже определена — это тот кадр. Модели нужно, чтобы вы предоставили инструкции для камеры: что движется, как и как быстро.
Структурируйте подсказку как три части
Подсказки, стабильно выдающие пригодные фрагменты, обычно по порядку охватывают три вещи:
- Действие субъекта — что делает субъект, с конкретным физическим описанием.
- Движение камеры — что делает камера, как единое чистое движение.
- Ритм — с какой скоростью действие разворачивается во фрагменте.
Например, вместо описания человека в комнате опишите, как субъект поворачивает голову к окну, камера медленно наезжает, движение постепенно разворачивается на протяжении всей длительности. Каждая часть соответствует тому, что модель может выполнить.
Оставляйте движение камеры единым
Одно движение на план. Наезд, панорама или ручной дрейф — выберите одно. Подсказки, требующие наезда одновременно с облётом и зумом, часто дают мутное, неопределённое движение. Если плану нужно два движения, это два плана.
Ритм под платформу, а не под модель
Зрители коротких видео свайпают быстро. Фрагмент, который тратит большую часть длительности на установление статичной сцены, теряет зрителей ещё до того, как что-то произойдёт. Пропишите ритм явно: немного движения в первые мгновения, затем камера стабильно входит в основное действие. Слова, передающие скорость, — постепенно, живо, непрерывно, с замедлением — полезнее длинного списка прилагательных.
Описывайте движение, а не эмоции
Эмоциональные слова дешевы и в основном игнорируются. Физические описания — нет. Предпочитайте наблюдаемые утверждения о телах, объектах и камере, а не абстрактные качества. Если вам нужен определённый эмоциональный вид, добивайтесь его через действие и ритм, а не через слова вроде «кинематографичный».
Управляйте версиями подсказок как кодом
Храните каждую подсказку вместе с идентификатором кадра, соотношением сторон и длительностью в репозитории или базе данных. Когда фрагмент получается хорошо, вы захотите знать, какая комбинация его произвела, чтобы позже прогнать эту комбинацию на целой партии похожих кадров.
Настройка соотношения сторон и длительности
Соотношение сторон и длительность — два параметра, которые с наибольшей вероятностью тихо ломают рабочий процесс, потому что ни один из них не появляется в подсказке, и оба меняют то, что считается хорошим результатом. Определите их один раз для каждого формата вывода и обращайтесь с ними как с константами.
Выбор соотношения сторон
Выберите пропорцию, которую фактически отображает ваша целевая платформа, и компонуйте статичный кадр для неё. Практическое следствие: не следует повторно использовать один и тот же кадр для вертикального и горизонтального формата без перекомпоновки — кадрирование, подходящее для высокого формата, редко подходит для широкого. Если нужны оба, ведите два набора статичных кадров из одной съёмки, каждый скомпонованный для своей пропорции.
После выбора записывайте эту пропорцию с каждым запросом. Смешанные пропорции в завершённой партии обычно означают, что кто-то изменил значение по умолчанию, а не принял решение.
Выбор длительности
Фрагменты коротких видео короткие. Планируйте длительность, соответствующую формату: достаточно долго, чтобы выполнить одно чёткое действие, достаточно коротко, чтобы не было простоя. Поскольку HiAPI тарифицирует image-to-video по длительности вывода, слишком длинные фрагменты стоят дороже и хуже проверяются — зрители редко досматривают фрагмент, которому уже нечего сказать.
Пишите подсказку так, чтобы она заполняла выбранную длительность. Описанное действие длиннее фрагмента создаёт резкий обрыв посреди действия; действие, завершающееся за малую часть длительности, оставляет пустоту в конце. Сознательно согласовывайте формулировки ритма с длиной.
Зафиксируйте оба параметра до масштабирования
Это самое важное правило процесса в этом руководстве. Настройка подсказок имеет смысл только при фиксированных соотношении сторон и длительности, потому что оба меняют восприятие движения. Если вы настроили подсказку при одной длительности, а затем сократили вывод, каждая одобренная вами подсказка становится непроверенным предположением. Зафиксируйте эту пару параметров, настраивайте под неё и меняйте только как осознанное событие перенастройки.
Параметры, которые стоит записывать при каждом запуске
Храните небольшую запись для каждой партии: соотношение сторон, длительность, маршрут модели, идентификатор группы кадров, версия подсказки. Этой записи из четырёх полей обычно достаточно, чтобы через несколько месяцев восстановить, почему фрагмент выглядел именно так, без необходимости рыться в логах.
Пакетная генерация в HiAPI
Как только группы кадров и схемы подсказок одобрены, генерация становится механической. Цель — небольшой скрипт, который разворачивает запросы и детерминированно собирает результаты, чтобы вы могли запускать его по расписанию, а не вручную.
Учётные данные и конфигурация
Храните учётные данные API в переменных окружения, никогда в скриптах или репозиториях. Читайте конечную точку и маршрут модели из конфигурации, чтобы позже можно было направить тот же скрипт на другой маршрут без изменения кода.
export HIAPI_API_KEY="your-key-here"
Рабочий запрос
Маршрут для этого рабочего процесса — wan2.7-video/image-to-video. Минимальный запрос содержит первый кадр, подсказку для камеры, соотношение сторон и длительность:
curl -X POST "https://api.hiapi.ai/v1/video/generations" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-video/image-to-video",
"image": "https://your-cdn.example/frames/shot-014.png",
"prompt": "Subject turns toward the window; slow push-in; gradual motion settling over the clip.",
"aspect_ratio": "9:16",
"duration": 5
}'
Прежде чем зацикливать что-либо, выполните один запуск на известном хорошем кадре. Один успешный запрос подтверждает ваши учётные данные, имя маршрута и структуру полезной нагрузки запроса.
Обход набора кадров
Пакетная генерация — это тот же запрос, повторённый с разными image и соответствующими подсказками. Организуйте входные данные как список записей, где каждая запись содержит URL кадра, его подсказку и имя вывода, которое вы контролируете. Итерируйте, отправляйте и записывайте возвращённые идентификаторы в входную запись.
Два практических правила цикла:
- Ограничивайте параллелизм. Отправка всех запросов сразу — самый быстрый способ упереться в ограничения скорости и потерять понимание, какой ответ какому входу соответствует. Умеренный пул воркеров с повторными попытками надёжнее, чем всплеск.
- Записывайте запросы вместе с результатами. Для каждой генерации сохраняйте URL кадра, подсказку, соотношение сторон, длительность и ссылку на возвращённый фрагмент. Без этого вы не сможете ни воспроизвести хороший фрагмент, ни объяснить плохой.
Сбор результатов
Скачивайте фрагменты в детерминированную структуру папок с ключом по идентификатору кадра и версии подсказки, затем передавайте папку на проверку. Стабильная схема именования означает, что ваш этап проверки — это просто вывод каталога, а не работа по сверке.
Идемпотентность при повторных запусках
Присвойте каждой паре кадр-подсказка стабильный хеш и пропускайте уже сгенерированные пары, если только вы не перегенерируете намеренно. Перегенерация всей партии, чтобы заполнить три пробела, — самый распространённый способ, которым команды тратят квоту в конвейерах image-to-video.

Проверка и итерация результатов
Проверка — это производственный этап, а не формальность. Смысл в том, чтобы быстро отнести каждый фрагмент к одному из трёх исходов — принять, переформулировать подсказку или перекомпоновать кадр, — чтобы вся партия продолжала двигаться.
Краткий чек-лист проверки
Проводите каждый возвращённый фрагмент через одинаковые последовательные проверки:
- Верность первому кадру — совпадает ли начальный момент с одобренным статичным кадром? Если он сразу отклоняется, проблема обычно в кадре, а не в подсказке.
- Правдоподобие движения — соответствует ли движение субъекта тому, как реально движутся тела и объекты? Следите за скольжением, деформацией конечностей, объектами, меняющими форму.
- Дисциплина камеры — выполняет ли камера именно то единое движение, которое вы запросили, или блуждает?
- Соответствие ритма — завершается ли действие в пределах длительности без лишнего хвоста и без обрыва посреди действия?
- Поиск дефектов — проверьте края, руки, лица, фоновый текст и любые области с мелкими деталями.
- Проверка формата — правильное ли соотношение сторон, находится ли субъект в безопасных полях относительно наложений интерфейса платформы?
Решения по сортировке
- Принять, если фрагмент проходит шесть проверок или имеет недостатки, невидимые в размере доставки.
- Переформулировать подсказку, если кадр хорош, но движение, камера или ритм неправильные. Измените одну часть подсказки и перегенерируйте.
- Перекомпоновать кадр, если дефекты движения можно проследить до двусмысленности в статичном кадре — неясное направление света, неуклюжее кадрирование или отсутствие подразумеваемого движения у субъекта.
Меняйте только одну переменную за итерацию. Одновременное изменение кадра и подсказки не скажет вам, какое исправление сработало.
Дешёвая проверка лучше идеального фрагмента
Для массового производства коротких видео быстрая проверка «прошёл/не прошёл» на многих фрагментах лучше, чем шлифовка одного фрагмента множеством перегенераций. Проверяйте в том размере, в котором зрители фактически увидят фрагмент, а не в полном разрешении, и увеличивайте только те фрагменты, которые собираетесь принять. Это делает этап проверки пропорциональным масштабу партии, а не вашей тревоге.
Возвращайте находки в процесс
Постоянно записывайте, какие паттерны подсказок и какие качества кадров связаны с уровнем принятия. Через несколько партий это превращается во внутренний стиль — небольшой набор частей подсказок и правил кадрирования, стабильно выдающих фрагменты, которые проверяющие одобрят без долгих споров.
Ловушки, которых следует избегать
Большинство проектов image-to-video, застрявших в производстве, терпят неудачу из-за проблем процесса, а не из-за модели. Вот несколько повторяющихся.
Настройка подсказок по движущейся цели
Изменение длительности или соотношения сторон в середине настройки делает недействительным каждое сравнение, которое вы делали. Сначала зафиксируйте оба, затем настраивайте. Если заинтересованные стороны требуют другой формат, рассматривайте это как новый цикл настройки с собственными одобренными подсказками, а не как подстройку параметра.
Отношение к статичному кадру как к второстепенному
Команды, которые быстро генерируют кадр и затем тратят все усилия на подсказки, быстро упираются в потолок. Кадр — это управляющий сигнал. Выделите реальное время на проверку статичных кадров и отклоняйте слабые кадры до того, как они попадут в генерацию.
Описание сцены вместо инструкций для камеры
Подсказки, полные эмоций и предыстории без физического действия, производят красивые фрагменты, в которых ничего не происходит. Каждая подсказка должна указывать, что движется и как быстро.
Неограниченный параллелизм и отсутствующие логи
Всплеск запросов и отбрасывание идентификаторов ответов делают партию невосстановимой. Записывайте входы и выходы вместе, ограничивайте количество рабочих потоков и делайте повторные запуски идемпотентными.
Отсутствие записей об одобрении
Если вы не можете указать точный кадр, подсказку, пропорцию и длительность, которые произвели принятый фрагмент, вы не можете его повторить. Эта цена проявится, когда вы впервые попытаетесь масштабировать серию и поймёте, что лучший фрагмент невозможно воспроизвести.
Чрезмерная генерация для заполнения небольших пробелов
Перезапуск всей партии из-за трёх неудачных фрагментов тратит время и бюджет. Отслеживайте статус каждого элемента и перегенерируйте только недостающие части.
Игнорирование безопасных зон платформы
Фрагмент, технически правильный, но с субъектом под наложением интерфейса платформы, будет читаться как повреждённый. Компонуйте статичные кадры с теми же безопасными полями, что и для любого другого доставляемого актива.
Ничего из этого не экзотично. Это просто обычная дисциплина производственного конвейера, применённая к модели, которая вознаграждает эту дисциплину.
Начните с одного одобренного кадра и одной подсказки, прогоните сквозной процесс на маршруте wan2.7-video/image-to-video, затем расширьте цикл на полную партию.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по началу работы с gpt-6.2-sol: границы возможностей, интеграция через API и тарификация токенов
Ключевые моменты принятия решений и практики интеграции для инженерных команд
-
Руководство по использованию
Руководство по началу работы с gpt-6.2-astra: границы возможностей текстовой модели, ключевые моменты интеграции и контроль затрат
-
Руководство по использованию
Руководство по началу работы с Tripo H3.1: три способа ввода, параметры и как выбрать тариф
Практическое руководство для разработчиков по принятию решений и контролю затрат при интеграции генерации 3D