FLUX 3 Video

Используйте flux-3-video для создания видеовыхода. Эта страница содержит полный запрос, необходимый для этой модели.

Факты о модели

Свойство	Значение
ID модели	`flux-3-video`
Эндпоинт	`POST /api/v1/generation/create`
Выход	Видео
Режимы	текст-видео, изображение-видео, продолжение видео
Цены	Посмотреть текущие цены

Минимальный запрос

curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-3-video",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}'

Ответ на создание содержит идентификатор задачи:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Параметры

Параметры относятся к объекту верхнего уровня input. Неизвестные поля отклоняются.

Параметр	Тип	Обязательно	По умолчанию	Описание
`prompt`	string	Да	—	Описание сцены: объект, действие, движение камеры, реплики и звук
`resolution`	“720p” \| “1080p”	Нет	`"720p"`	Разрешение видео (влияет на цену). Черновой режим — только 720p
`duration`	number	Нет	`5`	Длительность видео в секундах (5-20). Тарифицируется посекундно
`aspectRatio`	“auto” \| “21:9” \| “2:1” \| “16:9” \| “4:3” \| “1:1” \| “3:4” \| “9:16”	Нет	`"auto"`	Соотношение сторон. `auto` — модель выбирает сама по промпту и входным кадрам
`imageUrls`	string[]	Нет	—	Ключевые кадры по порядку воспроизведения. Один — первый кадр, два — первый и последний, три и больше — равномерно
`videoUrl`	string	Нет	—	Исходное видео (mp4) для продолжения. Тарифицируется по более высокой ставке, нельзя совмещать с `imageUrls`
`draft`	boolean	Нет	`false`	Черновой режим: быстрое превью 720p низкого качества примерно за треть цены
`safetyTolerance`	number	Нет	`2`	Строгость модерации от 0 (самая строгая) до 4 (самая мягкая)

Режимы

Минимальная генерация

{
  "model": "flux-3-video",
  "input": {
    "prompt": "A cinematic scene with soft natural light"
  }
}

С URL изображений

{
  "model": "flux-3-video",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "imageUrls": ["https://example.com/input.jpg"]
  }
}

С URL видео

{
  "model": "flux-3-video",
  "input": {
    "prompt": "A cinematic scene with soft natural light",
    "videoUrl": "https://example.com/input.mp4"
  }
}

Ограничения

resolution: разрешено: 720p, 1080p.
duration: минимум 5; максимум 20.
aspectRatio: разрешено: auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16.
safetyTolerance: минимум 0; максимум 4.

Неверные типы, неподдерживаемые значения перечислений, числа вне диапазона и отсутствующие обязательные поля возвращают HTTP 400 с error.code: "invalid_input". Исправьте запрос, а не пытайтесь выполнить его повторно без изменений.

Результат

Опрашивайте задачу или предоставьте URL верхнего уровня webhook в запросе на создание:

curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

Успешная медиа-задача возвращает один или несколько файлов:

{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://s3.apihubs.ru/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Смотрите Задачи и вебхуки для терминальных статусов, повторных попыток и доставки вебхуков.