Как использовать FLUX.3 Video API? Руководство на китайском по генерации из текста, из изображения и продолжению видео

TL;DR

• FLUX.3 Video — видеомодель от Black Forest Labs; на HiAPI у неё одно имя модели flux-3, и она поддерживает генерацию видео из текста, из изображения (1–10 ключевых кадров) и продолжение видео; длительность одного ролика 5–20 секунд, по умолчанию со синхронным звуком. Откройте страницу модели, чтобы генерировать онлайн; новым пользователям при регистрации даётся 200 кредитов.
• Оплата по секундам: 720p — $0.25 за секунду, 1080p — $0.42 за секунду; в режиме Draft-превью всего $0.09 за секунду. 5-секундное Draft-превью — $0.45.
• При настройке промпта обязательно сначала включайте draft: true: единственный обязательный параметр — prompt, но даже если не указывать остальные параметры, списание пойдёт по полному тарифу.

Сначала посмотрите результат

Пример со страницы модели: 720p, 5 секунд, со звуком:

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

Сгенерировать с этим промптом → (5 секунд, 720p)

Пример со страницы модели flux-3: 720p, 5 секунд, со звуком. По полному тарифу — $1.25, с Draft-превью — $0.45.

Цены

Режим	720p / секунда	1080p / секунда
Полная генерация (из текста, из изображения)	$0.25	$0.42
Draft-превью	$0.09	Не поддерживается
Продолжение видео (передать start_video)	$0.59	$0.76
Draft + продолжение видео	$0.18	Не поддерживается

Текущие цены HiAPI, проверено 15 октября 2026 г. Включён ли звук, на цену не влияет.

Длительность	Draft 720p	Полная 720p	Полная 1080p
5 секунд	$0.45	$1.25	$2.10
10 секунд	$0.90	$2.50	$4.20
20 секунд	$1.80	$5.00	$8.40

Рекомендуемый процесс: сначала в Draft отрегулируйте промпт и движение (от $0.45 за ролик), а после утверждения выпустите финальную версию в 720p или 1080p по полному тарифу.

curl: сначала запустите один Draft

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "Бумажный самолётик скользит по залитому солнцем офису, замедленная съёмка, камера следует за ним",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

5-секундный Draft, $0.45. После получения taskId проверьте результат:

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

Когда status станет success, скачайте видео по output[0].url; звук уже объединён в том же MP4.

Python: отправка, опрос, скачивание

# pip install requests; сначала export HIAPI_KEY=ваш_ключ
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # При повторной отправке той же задачи используйте тот же Idempotency-Key, чтобы избежать повторного списания
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# После утверждения выпускаем финальную версию 1080p
url = generate(
    prompt="Бумажный самолётик скользит по залитому солнцем офису, замедленная съёмка, камера следует за ним",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Этот ролик: 8 секунд, 1080p — $3.36.

Генерация из изображения: 1 первый кадр или до 10 ключевых кадров

Добавьте в input поле images (не image_urls); способ использования зависит от количества:

• 1 изображение: первый кадр.
• 2 изображения: первый и последний кадры, модель достраивает переход между ними.
• 3–10 изображений: раскадровка из ключевых кадров, равномерно распределённых по всему видео.

{
  "model": "flux-3",
  "input": {
    "prompt": "Плавный переход от рассвета к ночному городу в неоновых огнях, стабильная камера",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

Изображения поддерживаются в форматах PNG, JPEG, WebP. Генерация из изображения стоит столько же, сколько из текста.

Продолжение видео: снимаем дальше от готового видео

Передайте start_video, и модель продолжит генерацию с конца этого видео:

{
  "model": "flux-3",
  "input": {
    "prompt": "Камера продолжает двигаться вперёд, поезд въезжает в освещённый горный туннель",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video поддерживает только MP4, длительность до 15 секунд, размер до 50 MB.
• images и start_video нельзя передавать одновременно.
• Продолжение стоит дороже: 720p — $0.59 за секунду, Draft-продолжение — $0.18 за секунду.

Обзор параметров

Параметр	Значения	Описание
prompt	Строка, обязательно	Сцена, действие, движение камеры, реплики и звук — всё пишется здесь
duration	Целое число 5–20, по умолчанию 5	В секундах
resolution	720p / 1080p, по умолчанию 720p	Draft поддерживает только 720p; Draft с 1080p будет отклонён
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, по умолчанию auto
draft	По умолчанию false	Режим недорогого превью
generate_audio	По умолчанию true	Если отключить, на выходе видео без звука, цена не меняется
images	До 10 изображений	Генерация из изображения
start_video	URL файла MP4	Продолжение видео

Что учесть перед запуском в продакшен

• Используйте callback вместо опроса: на верхнем уровне запроса (на том же уровне, что и input) добавьте "callback": {"url": "https://ваш-домен/hiapi/callback"} и дедуплицируйте по taskId.
• Своевременно сохраняйте файлы: output[0].url — временная ссылка; сразу после получения сохраните видео в собственное хранилище.
• Повторные попытки с ключом идемпотентности: добавьте в заголовки Idempotency-Key; при повторе с тем же ключом задача создаётся только один раз, повторного списания не будет.
• Автоматический возврат при ошибке: оплата только за успешно сгенерированные видео.

Частые вопросы

Какова максимальная длительность одного ролика?

20 секунд. Если нужно длиннее, продолжайте генерацию с помощью продолжения видео.

Можно ли отключить звук? Будет ли дешевле?

Можно, generate_audio: false. Цена зависит только от разрешения, Draft и того, используется ли продолжение; отключение звука не делает дешевле.

Насколько Draft отличается от полного тарифа?

Для 720p — $0.09 против $0.25 за секунду: Draft дешевле примерно на 64% и генерирует быстрее, он подходит для настройки промпта.

Почему у имени модели нет суффикса /text-to-video?

FLUX.3 объединяет генерацию из текста, из изображения и продолжение в одном flux-3; режим различается тем, передаются ли images и start_video.

Хотите сначала попробовать один ролик — перейдите на страницу модели и сгенерируйте. Больше сравнений цен на видеомодели — на странице тарифов.