Skip to main content
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-video
string
обязательно
Промпт. Нельзя отправлять при использовании draft_from_task_id (будет отклонён).
integer
по умолчанию:"5"
Длительность в секундах, целое 5~20, по умолчанию 5
duration: "auto" не поддерживается (для биллинга нужна фиксированная длительность). Пропуск, "auto" или нецелые → трактуются как 5 секунд без ошибки и без адаптивной длины.
При продолжении видео фактическая длительность может быть меньше запрошенной (например, запрос 5 с, результат 4 с). Предварительно списывается плата за запрошенные секунды, после завершения разница возвращается; итоговая сумма — в cost запроса статуса. Для text/image-to-video такого разрыва нет.
string
по умолчанию:"hd"
Разрешение
  • hd (по умолчанию; также принимается 720p)
  • fhd (также принимается 1080p)
Измерения: hd ~1280×704 при 16:9; fhd ~1920×1088.
Режим черновика (draft:true) только допускает hd.
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: hd
string
Черновик → финал: ID вашей успешной черновой задачи
  • Можно менять только resolution; промпт, длительность, изображения, видео — нельзя
  • Тарифицируется по полной финальной цене; стоимость черновика не зачитывается
  • Взаимоисключающе с draft:true
integer
по умолчанию:"2"
Допуск модерации 0~4, по умолчанию 2 (выше = мягче)
Не путать с FLUX.2 images (05) или Kontext (06).
string
Явный режим (необязательно); см. Режимы генерации

Режим черновика

Двухшаговый процесс, когда итерации дороги:

Создать черновик

Черновик в финал

Переход черновик → финал перерендеривает в полном качестве с сохранёнными параметрами черновика (режим / промпт / seed / активы). Финализация черновиков продолжения — по тарифам финального продолжения.

Примеры запросов

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 — итоговая сумма. При сбоях — полный возврат.