Как использовать FLUX 3 API: полное руководство для разработчиков

Краткий ответ

FLUX 3 — мультимодальная видеомодель Black Forest Labs для генерации видео по тексту и изображению с синхронизированным звуком. В CometAPI ID продакшен‑модели — flux-3. Проверенный асинхронный рабочий процесс использует POST /v1/videos для создания задачи, GET /v1/videos/{task_id} для её опроса и GET /v1/videos/{task_id}/content для загрузки готового MP4.

Обновление доступности (подтверждено 24 сентября 2026): Black Forest Labs вывела FLUX 3 Video за рамки июльского этапа раннего доступа и сделала первоначальный релиз text-to-video и image-to-video общедоступным через BFL API и у выбранных партнёров 4 августа 2026. CometAPI добавила продакшен‑ID модели flux-3 в формате Video API 13 августа 2026. Используйте релизное объявление BFL и текущую страницу модели на CometAPI как источники истины по доступности, полям и ценам.

Что изменилось со времени раннего доступа FLUX 3?

Главное изменение — операционная доступность. Ранние материалы были сосредоточены на июльском запуске по заявкам, а августовский релиз BFL представил вызываемый видео‑эндпоинт, опубликованные ограничения и продакшен‑цены. Затем CometAPI открыл доступ к flux-3 через унифицированный рабочий процесс Video API.

Прежняя статья CometAPI, FLUX 3 API: Availability, Early Access, Video & Dev, остаётся полезной для истории запуска и предварительной июльской оценки. Более широкий обзор Best AI Video APIs in 2026 покрывает рыночный выбор. Это руководство держит те темы краткими и фокусируется на рабочих запросах, опросе, промптах, контроле затрат и продакшен‑обработке.

Что такое FLUX 3?

FLUX 3 — семейство мультимодальных моделей BFL для видео, аудио, изображений и предсказания действий. Текущий видеорелиз поддерживает text-to-video, image-to-video и продолжение видео через один нативный эндпоинт провайдера.

Для видеодевелоперов ключевые возможности: до 20 секунд при 24 fps, HD или Full HD вывод, синхронизированное аудио, многоязычная речь с липсинком, несколько шотов за одну генерацию и до десяти закреплённых ключевых кадров для контроля image-to-video.

Спецификации FLUX 3 API

Насколько хорош FLUX 3 Video?

BFL сообщает рейтинг Elo 1135 для text-to-video в своей оценке предпочтений людей «каждый‑с‑каждым». В той же опубликованной сравнительной оценке FLUX 3 сравнялся с Seedance 2.0 в предпочтениях для image-to-video и опередил остальные протестированные модели.

Эти результаты полезны как ориентир позиционирования, но это провайдерские оценки предпочтений, а не независимый продакшен‑бенчмарк. Они не измеряют задержки в шлюзе, надёжность очереди, стабильность стоимости или устойчивость повторных генераций, поэтому продакшен‑командам всё равно следует оценивать собственный набор промптов.

Результаты бенчмарков FLUX 3

Источник: Black Forest Labs — FLUX 3 Video, Часть 1: Генерация.

Что нужно перед использованием FLUX 3 API

• Аккаунт CometAPI и ключ API, сохранённый в переменной окружения на бэкенде.
• Промпт, задающий субъект, движение, направление камеры, атмосферу и требуемое аудио или диалоги.
• Надёжный путь обработки задач, поскольку генерация видео асинхронна.
• Достаточно кредитов для итерационного тестирования; биллинг зависит от сгенерированной длительности и разрешения.

Создайте ключ в панели CometAPI. Не размещайте его во фронтенд‑JavaScript, мобильных сборках, публичных репозиториях или скриншотах.

ID модели FLUX 3 и эндпоинты

Как использовать FLUX 3 API с CometAPI

Шаг 1: Установите ключ API

В macOS или Linux:

export COMETAPI_KEY="your_api_key"

В Windows PowerShell:

$env:COMETAPI_KEY="your_api_key"

Шаг 2: Создайте видео FLUX 3

Текущий квикстарт FLUX 3 использует multipart‑запрос с полями model, prompt, seconds и size. Этот пример запрашивает пятисекундный клип 720p:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Этот запрос запускает задачу. Не проектируйте приложение под получение готового MP4 в том же HTTP‑ответе.

Шаг 3: Сохраните ID задачи

Сохраните идентификатор сразу после успешного создания:

{
  "id": "video_task_id",
  "status": "queued"
}

Сохраните ID задачи рядом с записью пользователя или задания до начала опроса. Перезапуск процесса не должен приводить к потере генерации, за которую уже списана оплата.

Шаг 4: Опрос статуса видео

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

Начните с умеренного интервала, например десять секунд. Считайте completed, succeeded или success конечными состояниями успеха; failed, failure, cancelled или canceled — конечными состояниями ошибки.

Шаг 5: Загрузите MP4

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

После завершения скопируйте файл в собственное объектное хранилище или медиапайплайн, а не храните временный URL провайдера как постоянный ресурс.

Полный рабочий процесс на Python для генерации видео FLUX 3

Следующий пример создаёт задачу, сохраняет её ID, опрашивает до завершения, проверяет состояния ошибок, валидирует сигнатуру MP4 и записывает результат на диск.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Как использовать image-to-video и ключевые кадры

Страница CometAPI FLUX 3 указывает поддержку image-to-video. Её текущий публичный пример демонстрирует text-to-video, поэтому перед предположениями о поле reference‑image, позаимствованном у другой модели, проверьте живую документацию шлюза.

Нативный API BFL прозрачен: image-to-video использует mode i2v и поле keyframes. Одно изображение закрепляет стартовый кадр, два — начало и конец, до десяти изображений с таймингом позволяют сделать непрерывную «раскадровку» ролика.

Пример нативных ключевых кадров BFL

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Держите параметры нативного провайдера и шлюза в отдельных адаптерах. BFL использует поля вроде mode, keyframes, start_video, resolution и draft; проверенный пример CometAPI использует model, prompt, seconds и size.

Пояснение параметров FLUX 3 API

Как писать лучшие промпты для FLUX 3

Руководство по видеопромптам BFL рекомендует чётко задавать субъект и действие, камеру, сцену и атмосферу, качество движения и непрерывность. Для сцен, ведущихся аудио, указывайте диалог, голос, звуковые эффекты и фон.

Практическая структура промпта

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Кинематографичный промпт

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Промпт для продуктового видео

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Промпт с диалогом и нативным аудио

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

Промпт вроде «make a cinematic ramen shop video» оставляет движение, кадрирование, звук и непрерывность неопределёнными. Явные указания дают более воспроизводимое продакшен‑техническое задание.

Цены FLUX 3 API

Цены BFL зависят от сценария: полный text-to-video и image-to-video стоят $0.17/с в HD или $0.29/с в FHD, с черновым режимом HD по $0.06/с. Продолжение видео — $0.43/с в HD или $0.54/с в FHD, с HD‑черновиками по $0.12/с. CometAPI в настоящее время указывает flux-3 по $0.136/с для 720p и $0.232/с для 1080p. Перед массовыми партиями проверяйте актуальные цены.

Чтение двух последних столбцов: значения показаны сначала для HD/720p, затем для FHD/1080p.

Как снизить стоимость итераций

• Прототипируйте в 720p, прежде чем переводить выбранный промпт на 1080p.
• Используйте клипы по пять секунд для проверки композиции, движения и интерпретации промпта.
• Меняйте по одному крупному параметру промпта за итерацию.
• В нативном API BFL тестируйте черновой режим перед финальным качеством.
• Сохраняйте успешные промпты и референсы в метаданных приложения.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

Сравнивайте FLUX 3, Wan 3.0 и Seedance 2.5 по рабочим сценариям, а не ищите «универсального победителя». Авторитетные ссылки на спецификации остаются в заголовках таблицы ниже.

Примечание по ценам: стартовые цены — не сопоставление «качество/разрешение один‑к‑одному». Для бюджета используйте таблицу разрешений на живой странице каждой модели.

Какой Video API выбрать?

• Выберите FLUX 3 для реалистичного движения, синхронного звука, логики многошотов, нативных ключевых кадров или продолжения.
• Выберите Wan 3.0, когда важны множество типов входов и окно генерации 30 секунд.
• Выберите Seedance 2.5 для более длинного сторителлинга с насыщенными референсами и сильным контролем идентичности.

Рекомендации для продакшен‑использования FLUX 3 API

Храните асинхронные задачи как устойчивое состояние

Сохраняйте ID задачи сразу после отправки. Перезапуск сервера или повторная попытка воркера не должны заставлять пользователя платить за новую генерацию из‑за потери исходной задачи приложением.

Избегайте частого опроса

Начните с интервала около десяти секунд, если живые документы не рекомендуют иного. Опрос каждую секунду создаёт нагрузку на запросы без ощутимой выгоды.

Валидируйте загрузку

Проверьте длину содержимого и сигнатуру MP4 перед пометкой ассета как завершённого. Успешный HTTP‑ответ не всегда гарантирует валидное видео в теле.

Разделяйте схемы нативного API и шлюза

Поддерживайте отдельные адаптеры для нативных запросов BFL и CometAPI. Это предотвращает «утечку» полей вроде mode, keyframes и start_video в вызов через шлюз, который ожидает model, prompt, seconds и size.

Сохраняйте полный контекст ошибок

Логируйте HTTP‑статус, тело ответа, ID задачи, ID модели, версию промпта, размер, длительность и внутренний ID задания. Скрывайте ключ API.

Используйте небольшой набор для оценки перед релизом

Соберите 10–30 репрезентативных промптов, покрывающих движение камеры, людей, продукты, типографику, диалоги, динамичные сцены и нужные соотношения сторон. Запускайте тот же набор при изменении версии модели или интеграции и повторяйте важные промпты, поскольку генерация видео стохастична.

FAQ

Какой ID модели FLUX 3 в CometAPI?

Текущий ID модели — flux-3.

Какой эндпоинт использует FLUX 3 в CometAPI?

Проверенный рабочий процесс Video API использует POST /v1/videos, затем GET /v1/videos/{task_id} и GET /v1/videos/{task_id}/content.

Является ли FLUX 3 синхронным?

Нет. Относитесь к нему как к асинхронной задаче: отправьте, сохраните ID задачи, опрашивайте и скачайте.

Какой длины видео может генерировать FLUX 3?

BFL документирует 5–20 секунд для T2V/I2V и 5–15 секунд для продолжения.

Генерирует ли FLUX 3 аудио?

Да. BFL документирует синхронизированное аудио по умолчанию в нативном API.

Поддерживает ли FLUX 3 image-to-video?

Да. CometAPI указывает поддержку image-to-video, а в нативном API BFL это реализовано через режим i2v и ключевые кадры.

Можно ли использовать ключевые кадры BFL через CometAPI без изменений?

Не стоит так предполагать. Схемы запросов различаются; проверьте текущий квикстарт CometAPI, прежде чем запускать workflow с reference‑image через шлюз.

Сколько стоит пятисекундное видео FLUX 3 в CometAPI?

По текущим ставкам CometAPI, пять секунд стоят $0.68 при 720p или $1.16 при 1080p. Смотрите сводную таблицу цен выше и живую ссылку.

FLUX 3 лучше, чем Wan 3.0 или Seedance 2.5?

Зависит от сценария. FLUX 3 силён для согласованных по движению аудиовизуальных шотов и нативного контроля ключевых кадров или продолжения; Wan 3.0 делает упор на широту входов; Seedance 2.5 — на более длинный сторителлинг с плотными референсами.

Заключение

FLUX 3 теперь имеет рабочий асинхронный путь Video API в CometAPI, тогда как нативная документация BFL раскрывает более глубокие настройки ключевых кадров, продолжения, аудио и чернового режима.

Безопасный путь интеграции прост: начните с короткого запроса 720p text-to-video, сохраните ID задачи, опрашивайте с разумной частотой, скачайте и проверьте MP4, затем добавляйте шаблоны промптов, хранилище, логику повторов и воспроизводимый набор для оценки. Держите схемы нативного API и шлюза раздельно и проверяйте живую страницу модели перед жёстким кодированием полей или цен.