FLUX 3 Video
Генерация видео FLUX 3
- Асинхронный режим обработки, возвращает ID задачи для последующих запросов
- Единая точка входа: text-to-video / image-to-video / продолжение видео / двухшаговый черновик
- Вывод H.264 + AAC с синхронным аудио, длительность 5~20 секунд
- Разрешение hd / fhd, семь соотношений сторон
POST
Авторизация
string
обязательно
Все конечные точки требуют аутентификации Bearer TokenПолучите API Key на странице управления API Key:
Режимы генерации
flux-3-video — единая точка входа: режим выводится из полей или задаётся явно через mode.
Значения
mode: t2v / i2v / v2v / draft_enhance или официальные text-to-video / image-continuation / video-continuation. Явный mode имеет наивысший приоритет.
Семантика ключевых кадров image-to-video
Порядок вimage_urls семантичен — не сортируйте и не удаляйте дубликаты:
Параметры запроса
string
обязательно
Фиксированное значение:
flux-3-videostring
обязательно
Промпт. Нельзя отправлять при использовании
draft_from_task_id (будет отклонён).integer
по умолчанию:"5"
Длительность в секундах, целое 5~20, по умолчанию
5При продолжении видео фактическая длительность может быть меньше запрошенной (например, запрос 5 с, результат 4 с). Предварительно списывается плата за запрошенные секунды, после завершения разница возвращается; итоговая сумма — в
cost запроса статуса. Для text/image-to-video такого разрыва нет.string
по умолчанию:"hd"
Разрешение
hd(по умолчанию; также принимается720p)fhd(также принимается1080p)
hd ~1280×704 при 16:9; fhd ~1920×1088.string
по умолчанию:"auto"
Соотношение сторонВарианты:
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 или auto (по умолчанию; выбирается автоматически по промпту и материалам)string[]
Ключевые кадры image-to-video, 1~10, публичный http(s) URL или base64
string
Входное видео для продолжения (mp4, публичный URL или base64)
string[]
То же, что
video_url; используется первый элемент (совместимость)boolean
по умолчанию:"true"
Генерировать синхронное аудио, по умолчанию
true. false даёт немое видео (без скидки)boolean
по умолчанию:"false"
Режим черновика: ~1/3 цены низкокачественный превью; только с
resolution: hdstring
Черновик → финал: ID вашей успешной черновой задачи
- Можно менять только
resolution; промпт, длительность, изображения, видео — нельзя - Тарифицируется по полной финальной цене; стоимость черновика не зачитывается
- Взаимоисключающе с
draft:true
integer
по умолчанию:"2"
Допуск модерации 0~4, по умолчанию
2 (выше = мягче)Не путать с FLUX.2 images (05) или Kontext (06).
string
Явный режим (необязательно); см. Режимы генерации
Режим черновика
Двухшаговый процесс, когда итерации дороги:Создать черновик
Черновик в финал
Примеры запросов
Text-to-video (портрет)
Image-to-video (старт + конечный кадр)
Продолжение видео
Немое видео
Ограничения
Частые ошибки отправки (обычно без списания)
Отказы модерации завершаются как
failed с полным возвратом.
Покрытие возможностей
Response
integer
Код статуса; 200 при успехе
array
Массив данных ответа
Запрос результатовГенерация видео асинхронна. Опрашивайте Получить статус задачи.Рекомендуемый интервал 5~10 секунд; таймаут клиента 15 минут (20 с fhd медленнее). Измерения ~60 с для
t2v + hd + 5 с.При успехе используйте result.videos[0].url; активы зеркалируются на CDN платформы. cost — итоговая сумма. При сбоях — полный возврат.