FLUX 3 API

Видео FLUX 3 со звуком до 20 секунд: по описанию, по кадрам или продолжение готового ролика. Черновик стоит примерно треть полного видео.

Разработчик: Black Forest LabsКлюч модели в API: flux3

Для нейросети:Скачать .md Вся документация .md Открыть как текст

Подключение в три шага

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "flux3",
  "settings": {
    "mode": "t2v",
    "prompt": "Лиса бежит сквозь утренний туман, под лапами хрустят ветки",
    "aspect_ratio": "16:9",
    "duration": 8
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "flux3",
    "settings": {
        "mode": "t2v",
        "prompt": "Лиса бежит сквозь утренний туман, под лапами хрустят ветки",
        "aspect_ratio": "16:9",
        "duration": 8,
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "flux3",
  "settings": {
    "mode": "t2v",
    "prompt": "Лиса бежит сквозь утренний туман, под лапами хрустят ветки",
    "aspect_ratio": "16:9",
    "duration": 8
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Получить ключ

Цена до запуска

Цены на 15.10.2026: от 43 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
По описанию	от 43 ₽
По кадрам	от 43 ₽
Продолжение видео с файлом на 1 с	от 86 ₽

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "flux3",
  "settings": {
    "mode": "t2v",
    "prompt": "Лиса бежит сквозь утренний туман, под лапами хрустят ветки",
    "aspect_ratio": "16:9",
    "duration": 8
  }
}'

amount_minor: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле mode.

По описанию mode = t2v
По кадрам mode = i2v
Продолжение видео mode = v2v

По описанию

Видео только по тексту, файлы не передаются.

Значение поля mode: t2v

Цена в этом режиме от 43 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео: сцена, движение камеры, звуки. Реплики и надписи в кадре тоже можно описать словами.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
renderНеобязательно: Полное видео или черновик. Черновик быстрее, всегда в HD и стоит примерно треть полного. Пересобрать черновик в полном качестве через API нельзя: полное видео это новая генерация, и сцена может выйти иначе.
Тип: СтрокаДопустимые значения: fulldraftПо умолчанию: "full"
resolutionНеобязательно: Качество полного видео: HD или Full HD, Full HD дороже. Черновик всегда в HD, для него это поле не действует.
Тип: СтрокаДопустимые значения: hdfhdПо умолчанию: "hd"
aspect_ratioНеобязательно: Пропорции видео. Авто: модель подберёт сама, по кадрам или по исходному ролику.
Тип: СтрокаДопустимые значения: auto21:92:116:94:31:13:49:16По умолчанию: "9:16"
audioНеобязательно: Со звуком или без. Речь, эффекты и фон модель пишет в том же запуске, отдельно звук не оплачивается.
Тип: СтрокаДопустимые значения: onoffПо умолчанию: "on"
durationНеобязательно: Длительность видео в секундах, от 5 до 20. Цена за секунду, поэтому растёт вместе с длительностью.
Тип: Целое числоМинимум: 5Максимум: 20По умолчанию: 5

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true

Входные данные

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Видео по описанию

JSON

{
  "model": "flux3",
  "settings": {
    "mode": "t2v",
    "prompt": "Лиса бежит сквозь утренний туман, под лапами хрустят ветки",
    "aspect_ratio": "16:9",
    "duration": 8
  }
}

Черновик, чтобы проверить идею

JSON

{
  "model": "flux3",
  "settings": {
    "mode": "t2v",
    "prompt": "Бармен подбрасывает шейкер, ловит его за спиной и говорит: «Ваш коктейль»",
    "render": "draft",
    "duration": 6
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4, 24 кадра в секунду, со звуком, если он не выключен.
Генерация занимает от 1 до 10 минут в зависимости от длины и качества.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

По кадрам

Ваши картинки становятся кадрами видео: одна открывает ролик, две задают начало и конец, больше двух модель расставит равномерно от начала к концу.

Значение поля mode: i2v

Цена в этом режиме от 43 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео: сцена, движение камеры, звуки. Реплики и надписи в кадре тоже можно описать словами.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
renderНеобязательно: Полное видео или черновик. Черновик быстрее, всегда в HD и стоит примерно треть полного. Пересобрать черновик в полном качестве через API нельзя: полное видео это новая генерация, и сцена может выйти иначе.
Тип: СтрокаДопустимые значения: fulldraftПо умолчанию: "full"
resolutionНеобязательно: Качество полного видео: HD или Full HD, Full HD дороже. Черновик всегда в HD, для него это поле не действует.
Тип: СтрокаДопустимые значения: hdfhdПо умолчанию: "hd"
aspect_ratioНеобязательно: Пропорции видео. По умолчанию Авто: модель подберёт их по вашим кадрам.
Тип: СтрокаДопустимые значения: auto21:92:116:94:31:13:49:16По умолчанию: "auto"
audioНеобязательно: Со звуком или без. Речь, эффекты и фон модель пишет в том же запуске, отдельно звук не оплачивается.
Тип: СтрокаДопустимые значения: onoffПо умолчанию: "on"
durationНеобязательно: Длительность видео в секундах, от 5 до 20. Цена за секунду, поэтому растёт вместе с длительностью.
Тип: Целое числоМинимум: 5Максимум: 20По умолчанию: 5
image_urlsОбязательно: От одной до десяти ссылок на кадры, по порядку.
Тип: Список (Строка, uri)Максимум элементов: 10

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true

Входные данные

Кадры передаются ссылками на картинки JPEG, PNG или WebP, каждая не меньше 256 на 256 точек.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`image_urls`	Картинки	jpeg, jpg, png, webp	10

Как передать файлы

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Оживить кадр

JSON

{
  "model": "flux3",
  "settings": {
    "mode": "i2v",
    "prompt": "Камера медленно наезжает, листья шевелятся на ветру",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ]
  }
}

Начало и конец

JSON

{
  "model": "flux3",
  "settings": {
    "mode": "i2v",
    "prompt": "Бутон распускается в цветок, капли росы блестят на солнце",
    "aspect_ratio": "1:1",
    "duration": 6,
    "image_urls": [
      "https://example.com/bud.png",
      "https://example.com/flower.png"
    ]
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4, 24 кадра в секунду, со звуком, если он не выключен.
Генерация занимает от 1 до 10 минут в зависимости от длины и качества.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Продолжение видео

Модель продолжает ваш ролик с его последних кадров. Исходник в результат не входит. Стоит заметно дороже остальных режимов.

Значение поля mode: v2v

Цена в этом режиме от 86 ₽, с файлом на 1 с.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео: сцена, движение камеры, звуки. Реплики и надписи в кадре тоже можно описать словами.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
renderНеобязательно: Полное видео или черновик. Черновик быстрее, всегда в HD и стоит примерно треть полного. Пересобрать черновик в полном качестве через API нельзя: полное видео это новая генерация, и сцена может выйти иначе.
Тип: СтрокаДопустимые значения: fulldraftПо умолчанию: "full"
resolutionНеобязательно: Качество полного видео: HD или Full HD, Full HD дороже. Черновик всегда в HD, для него это поле не действует.
Тип: СтрокаДопустимые значения: hdfhdПо умолчанию: "hd"
aspect_ratioНеобязательно: Пропорции видео. По умолчанию Авто: продолжение берёт пропорции исходного ролика, и стык выходит ровным.
Тип: СтрокаДопустимые значения: auto21:92:116:94:31:13:49:16По умолчанию: "auto"
audioНеобязательно: Со звуком или без. Речь, эффекты и фон модель пишет в том же запуске, отдельно звук не оплачивается.
Тип: СтрокаДопустимые значения: onoffПо умолчанию: "on"
durationНеобязательно: Длительность видео в секундах, от 5 до 15. Цена за секунду, поэтому растёт вместе с длительностью.
Тип: Целое числоМинимум: 5Максимум: 15По умолчанию: 5
video_urlsОбязательно: Одна ссылка на ролик MP4, который нужно продолжить.
Тип: Список (Строка, uri)Максимум элементов: 1

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: files_as_is = true

Входные данные

Ролик передаётся ссылкой на MP4 до 50 МБ и не длиннее 60 секунд. Он уходит целиком, обрезки нет: лишнее отрежьте заранее.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`video_urls`	Видео	mp4	1	50 МБ

Как передать файлы

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

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Продолжить ролик

JSON

{
  "model": "flux3",
  "settings": {
    "mode": "v2v",
    "prompt": "Машина уходит в поворот, из-под колёс летит гравий, камера догоняет её",
    "duration": 5,
    "video_urls": [
      "https://example.com/clip.mp4"
    ]
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4, 24 кадра в секунду, со звуком, если он не выключен.
Генерация занимает от 1 до 10 минут в зависимости от длины и качества.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Смотрите также

Нейросеть FLUX 3: возможности и цены
Похожие модели: Seedance 2.5 API, Kling 3.0 API, Kling Motion 3.0 API, Veo 3.1 API, Wan 3.0 API, MiniMax H3 (Hailuo 03) API
Документация API
Ошибки API и что с ними делать

Попробуйте FLUX 3 через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API