Пакетная генерация коротких видео с помощью hailuo-2.3-fast/image-to-video на hiapi

Успех коротких видео зависит от скорости итераций. Если ваш рабочий процесс ориентирован на конвейер для TikTok или Reels, вам не нужен кинематографичный вывод в 4K — вам нужна модель, которая превращает статичное изображение продукта в пригодный фрагмент менее чем за минуту, причём достаточно дешёвая, чтобы вы могли прогнать десятки вариантов, прежде чем выбрать лучший. Именно так позиционируется hailuo-2.3-fast/image-to-video: Fast-версия ветки hailuo-2.3, ценообразование и настройка которой специально ориентированы на высокопроизводительные рабочие процессы с множеством выбрасываемых попыток.

Это руководство проведёт вас через использование модели как движка пакетной генерации коротких видео: как выбирать исходные статичные изображения, как управлять ею через асинхронный API задач, как проверять те детали схемы, которые без проверки приведут к ошибкам 400, и как оценивать экономику запуска в масштабе TikTok/Reels.

Что даёт модель

hailuo-2.3-fast/image-to-video принимает одно статичное изображение и промпт и анимирует их в короткий видеоклип. Она размещена на странице модели hailuo-2.3-fast/image-to-video и — как и все модели на hiapi — вызывается через единый асинхронный эндпоинт /v1/tasks: вы отправляете POST-запрос с задачей, опрашиваете (или регистрируете callback) до завершения, а затем загружаете видео по кратковременно действующему выходному URL.

На момент написания проверено на работающем API:

• Вход: одно изображение (image_url) + текстовый промпт, описывающий желаемое движение
• Выход: MP4, фиксированная длительность 6s или 10s (произвольная длина не поддерживается)
• Цена: фиксированная цена за видео, а не поминутная оплата — 6-секундный клип $0.27, 10-секундный клип $0.46
• Время обработки: наш тестовый клип от начала до конца (отправка → успех) завершился примерно за 80 секунд

Фиксированная цена за видео — ключевая деталь для пакетных задач: попытка на 6 секунд стоит одинаково, независимо от того, попали ли вы в нужный эффект движения с первого раза или уже пробуете в четвёртый. По цене Fast-уровня запуск 5-6 вариантов для одного и того же ключевого изображения, чтобы найти вариант с наиболее плавным движением, всё равно обойдётся дешевле, чем одна попытка большинства премиальных видеомоделей. Перед составлением бюджета пакетной обработки проверьте актуальные цифры на странице цен — цены меняются.

Если вам нужен полный справочник параметров, более длительные опции или сравнение бок о бок с не-Fast уровнем hailuo-2.3, обратитесь к нашему учебнику по интеграции API hailuo-2.3-fast/image-to-video — это руководство посвящено пакетному/рабочему процессу, а не оригинальному справочнику API.

Рабочий процесс: статичное изображение → короткий видеоклип

Схема коротких видео проста: начните с уже имеющегося статичного изображения (фотография продукта, сгенерированный hero shot, брендовый материал) и позвольте модели добавить движение — медленный наезд камеры, лёгкое вращение, атмосферное парение — вместо генерации видео с нуля. Это фиксирует вашу визуальную идентичность (тот же продукт, то же освещение, та же композиция), одновременно создавая контент, который не является статичным постом.

Это реальный пример запуска: вертикальное (9:16) статичное изображение кроссовка на подсвеченном подиуме, управляемое промптом, описывающим медленный наезд камеры и плавное вращение.

Исходное статичное изображение и полный запрос:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3-fast/image-to-video",
    "input": {
      "prompt": "Slow smooth push-in on a chunky retro basketball sneaker in wolf-gray suede with volt yellow laces, floating above a wet concrete pedestal, subtle rotation revealing the side panel, mist drifting through teal-to-amber rim light, dust particles catching the light, stable cinematic camera movement, premium commercial product-video finish",
      "image_url": "https://static.hiapi.ai/gallery/2026/07/c2e71481d2eb81a7.jpg",
      "duration": "6",
      "prompt_optimizer": true
    }
  }'

Ответ:

{"code":200,"data":{"taskId":"tk-hiapi-01KZ5FJV0TB8EYKDCV58FQ1F2X"},"message":"success"}

Опрашивайте до завершения обработки:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-01KZ5FJV0TB8EYKDCV58FQ1F2X \
  -H "Authorization: Bearer $HIAPI_API_KEY"

{
  "status": "success",
  "output": [{"type": "video", "url": "https://temp.hiapi.ai/.../result.mp4", "expireAt": 1786421652}]
}

Этот output[0].url временный — немедленно скачайте и перенесите его в собственное хранилище. Не используйте горячие ссылки на него и не сохраняйте его в поле базы данных в надежде, что это стабильный URL.

Схема входных данных (проверено на работающем API)

Схема этой модели гораздо уже, чем вы могли ожидать от других видеомоделей платформы — нет управления соотношением сторон, нет уровней разрешения, нет seed.

Поле	Тип	Ограничение	Обязательно
prompt	string	Описание движения/сцены	Да
image_url	string	Единственное число — один публичный URL, не массив	Да
duration	string	Перечисление "6" или "10" — как строка, не число	Да
prompt_optimizer	boolean	Разрешить платформе переписывать/усиливать ваш промпт	Нет

Если вы перенесёте предположения от других моделей, две ловушки приведут к ошибке 400:

1. image_url в единственном числе, не image_urls. Несколько других i2v-моделей на hiapi принимают массив референсных изображений; эта модель принимает только одно. Отправив массив, вы получите ошибку отсутствующего поля, а не полезное преобразование типа.
2. duration должна быть строкой "6" или "10", а не числом 6. Отправка числа 6 вернёт duration: got number, want string. И любое значение вне этого перечисления из двух значений не принимается — в этом уровне нет управления произвольной длительностью.

Отправка aspect_ratio, resolution, seed или watermark — все эти поля распространены в родственных моделях — будет напрямую отклонена с ответом additional properties ... not allowed. Модель наследует соотношение сторон от входного изображения, поэтому если вам нужен вывод 9:16 для Reels/TikTok, обрежьте или сгенерируйте исходное статичное изображение в формате 9:16 перед отправкой (именно так мы поступили с изображением кроссовка выше).

Полный пример на Python

import requests
import time

API_BASE = "https://api.hiapi.ai/v1/tasks"
API_KEY = "your-api-key"

def make_short_clip(prompt: str, image_url: str, out_path: str, duration: str = "6"):
    resp = requests.post(
        API_BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "hailuo-2.3-fast/image-to-video",
            "input": {
                "prompt": prompt,
                "image_url": image_url,
                "duration": duration,  # must be a string: "6" or "10"
                "prompt_optimizer": True,
            },
        },
        timeout=60,
    )
    resp.raise_for_status()
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(f"{API_BASE}/{task_id}",
                             headers={"Authorization": f"Bearer {API_KEY}"},
                             timeout=30).json()["data"]
        if task["status"] == "success":
            break
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(8)

    video_url = task["output"][0]["url"]  # temporary link — download immediately
    video_bytes = requests.get(video_url, timeout=120).content
    with open(out_path, "wb") as f:
        f.write(video_bytes)
    return out_path

Для настоящего пакетного запуска — например, тестирования 6 вариантов промптов на одном исходном статичном изображении, чтобы выбрать наиболее плавное движение — оберните эту функцию в цикл по списку промптов и проверяйте каждый task_id независимо, а не последовательно блокируясь; при расчёте около 80 секунд на клип параллельный запуск нескольких задач — это то, что действительно позволяет Fast-уровню ощущаться быстрым.

Часто задаваемые вопросы

Могу ли я управлять соотношением сторон вывода? Нет — у этой модели нет поля aspect_ratio, его отправка вернёт 400. Вывод следует соотношению сторон входного изображения, поэтому подготовьте исходное статичное изображение в нужной пропорции перед отправкой (9:16 для Reels/TikTok, 1:1 для постов в ленте).

Почему мой запрос не проходит с сообщением "got number, want string"? Вы отправили duration как JSON-число. Она должна быть строкой "6" или "10" — это единственные два допустимых значения.

Это та же модель, что hailuo-2.3/image-to-video (не Fast)? Нет — Fast-уровень — это отдельная, по-своему оценённая модель на hiapi со своей схемой, настроенная на скорость и стоимость, а не на стандартный уровень. Если вам нужен обзор не с точки зрения пакетной обработки, обратитесь к полному учебнику по интеграции.

Могу ли я подавать сгенерированные изображения вместо реальных фотографий? Да — исходное статичное изображение может быть получено от любой модели изображений на hiapi (или где-либо ещё), главное, чтобы это был публично доступный URL. Использование изображений, которые вы уже создали для других форматов (визуалы продуктов, постеры), обычно самый быстрый способ получить короткое видео без отдельного творческого процесса.

Меняется ли цена в зависимости от разрешения? У этой модели нет параметра разрешения, поэтому цена фиксирована и зависит от длительности независимо от разрешения входного изображения — на момент написания 6s $0.27, 10s $0.46. Проверьте на странице цен.

Ключевые выводы

• hailuo-2.3-fast/image-to-video превращает одно статичное изображение в 6s или 10s MP4 по фиксированной цене за видео ($0.27 / $0.46), а не поминутно — достаточно дешево, чтобы запускать несколько вариантов промптов на каждое исходное изображение.
• Схема намеренно узкая: prompt, image_url (единственное число), duration (строковое перечисление "6"/"10") и опциональный prompt_optimizer — нет управления соотношением сторон, разрешением или seed.
• Вывод наследует соотношение сторон входного изображения, поэтому перед отправкой подготовьте исходное статичное изображение в формате 9:16 (или любой пропорции, требуемой вашей платформой).
• Две наиболее частые ошибки интеграции — отправка image_url в виде массива и отправка duration числом вместо строки.
• Для пакетных рабочих процессов с короткими видео фиксированная цена за видео и время обработки около 80 секунд делают практичным создание нескольких попыток и выбор лучшего движения, а не единственную генерацию на каждый материал.

Готовы попробовать на своих изображениях продуктов? Перейдите на страницу модели hailuo-2.3-fast/image-to-video, чтобы протестировать запрос напрямую, или, если вы хотите сначала сравнить Fast-уровень с другими вариантами image-to-video, посетите полный каталог моделей.