FLUX 3 API
FLUX 3 API от Black Forest Labs доступен в WaveSpeedAI: конечные точки text-to-video, image-to-video, видео по начальному и конечному кадру, продление видео, Draft и апскейл видео. Создавайте клипы длиной от 5 до 20 секунд в 720P или 1080P с синхронизированным звуком по желанию через один готовый к продакшену API.
Это руководство по FLUX 3 API описывает работающие конечные точки WaveSpeedAI, цены, примеры, порядок интеграции, варианты Draft и продакшен-процессы с видео. Playground, карточки конечных точек, цены, примеры и образцы API ниже используют актуальное семейство black-forest-labs/flux-3.
Обзор
О модели FLUX 3 API
Что делает FLUX 3, какое место занимает в линейке моделей Black Forest Labs и почему её выбирают команды.
FLUX 3 — модель генерации видео от Black Forest Labs, доступная через REST API WaveSpeedAI. FLUX 3 API от Black Forest Labs доступен в WaveSpeedAI: конечные точки text-to-video, image-to-video, видео по начальному и конечному кадру, продление видео, Draft и апскейл видео. Создавайте клипы длиной от 5 до 20 секунд в 720P или 1080P с синхронизированным звуком по желанию через один готовый к продакшену API.
Это руководство по FLUX 3 API описывает работающие конечные точки WaveSpeedAI, цены, примеры, порядок интеграции, варианты Draft и продакшен-процессы с видео. Playground, карточки конечных точек, цены, примеры и образцы API ниже используют актуальное семейство black-forest-labs/flux-3.
Семейство FLUX 3 в WaveSpeedAI включает 12 REST-эндпоинтов для сценариев: Video-To-Video, Upscale-Video, Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. У каждого варианта свои цены, параметры и примеры результатов — выберите тот, что подходит под ваш тип входных данных и требования продакшена, или вызывайте несколько с одним API-ключом и собирайте многошаговые пайплайны.
Запускайте FLUX 3 с тем же API-ключом, платёжным аккаунтом и лимитами, что и остальные 1000+ ИИ-моделей WaveSpeedAI. Без отдельной регистрации у вендора, без SDK для каждого провайдера, без разных лимитов у каждого поставщика — одна интеграция охватывает всё: от текста в изображение и текста в видео до синтеза аудио, 3D-генерации, апскейлинга и редактирования.
Характеристики
Возможности FLUX 3 API и статус релиза
То, что разработчики ищут перед выбором API: доступность, ожидаемая длина результата, поддержка референсов и текущая рабочая альтернатива.
Доступность
Уже доступно
Девять конечных точек FLUX 3 работают в каталоге WaveSpeedAI: генерация, продление, итерации на Draft и апскейл видео по стандартному REST-процессу предсказаний.
Длительность видео
5–20 секунд
Создавайте клипы от 5 до 20 секунд из текста, одного исходного изображения, начального и конечного изображений или продлевайте существующее видео новым продолжением.
Результат
720P / 1080P
Стандартные конечные точки генерации поддерживают вывод в 720P и 1080P с синхронизированным звуком по желанию. Апскейл видео поддерживает настраиваемый масштаб от 1,5x до 3x.
Итерации
Конечные точки Draft
Варианты Draft для text-to-video, image-to-video, видео по начальному и конечному кадру и продления видео дают более дешёвый способ подбирать промпт и движение.
Эндпоинты
Все эндпоинты API FLUX 3
Сейчас в WaveSpeedAI доступно эндпоинтов FLUX 3: 12 — выберите вариант под ваш сценарий.
/filters:quality(82)/media/images/1789113620754515887_hYMV3cmw.webp)
Flux 3 Video Edit
FLUX 3 Video Edit applies prompt-guided changes to existing videos while preserving motion, timing, and framing, supporting precise video modification, visual style updates, scene refinements, creative edits, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1787298940011758698_4IrBKT1b.webp)
Flux 3 Video Upscale
FLUX Video Upscale enhances MP4 videos with source-faithful or creative detail reconstruction, configurable 1.5x to 3x scaling, and improved visual clarity for video restoration, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921290885950224_DdmvFOAJ.webp)
Flux 3 Image Edit
FLUX 3 Image Edit transforms and combines up to 10 input images using natural-language instructions, with flexible 1K / 2K / 4K output for multi-image composition, visual refinements, creative edits, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1790921222365478560_RbW6fpyI.webp)
Flux 3 Text To Image
FLUX 3 Text-to-Image generates high-quality images from text prompts with detailed composition, strong typography, and flexible 1K / 2K / 4K output for creative visuals, marketing assets, product imagery, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1786251291501821218_QDkaw5jG.webp)
Flux 3 Video Extend Draft
FLUX 3 Video Extend Draft quickly continues a required input video into a draft clip with prompt-guided next-scene motion, optional synchronized audio, and flexible 5-20 second duration for rapid iteration.
/filters:quality(82)/media/images/1786251321454460317_x5e3clvE.webp)
Flux 3 Text To Video Draft
FLUX 3 Text-to-Video Draft generates short draft videos from text prompts with coherent motion, prompt-guided camera direction, optional synchronized audio, and pricing optimized for rapid iteration.
/filters:quality(82)/media/images/1786251351572590694_qiqJaC8C.webp)
Flux 3 Image To Video Draft
FLUX 3 Image-to-Video Draft quickly animates a required reference image into a draft clip with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid visual iteration.
/filters:quality(82)/media/images/1786251386747220978_8aWoJ0iz.webp)
Flux 3 Start End To Video Draft
FLUX 3 Start-End-to-Video Draft quickly generates a transition between required start and end images, with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid keyframe iteration.
/filters:quality(82)/media/images/1785952605637015407_SuDLV4DN.webp)
Flux 3 Text To Video
FLUX 3 Text-to-Video generates cinematic 5-20 second videos from text prompts, with coherent motion, cinematic composition, optional synchronized audio, and 720P / 1080P output for creative videos, social content, ads, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785953660196858181_bUeDcy0o.webp)
Flux 3 Video Extend
FLUX 3 Video Extend continues input videos into new 5-20 second clips, using prompt guidance to control the next action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952695147978688_UKcluENW.webp)
Flux 3 Start End To Video
FLUX 3 Start-End-to-Video generates 5-20 second transition videos between required start and end images, using prompt guidance to control action, camera movement, visual style, motion continuity, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785952675883482836_NxW5IR09.webp)
Flux 3 Image To Video
FLUX 3 Image-to-Video animates a required reference image into a 5-20 second video, preserving subject appearance while using prompt control to guide motion, camera movement, visual style, and optional synchronized audio at 720P / 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Примеры
FLUX 3 в деле
Реальные результаты, созданные через API FLUX 3. Наведите курсор на видео для предпросмотра, нажмите, чтобы открыть в полном размере.
Как использовать
Как использовать API FLUX 3
Четыре шага от регистрации до готовой генерации. Полные примеры на Python, Node.js и cURL — в разделе API ниже.
- 01
Получите API-ключ
Создайте аккаунт WaveSpeedAI и скопируйте API-ключ на панели управления. Новые аккаунты получают бесплатные стартовые кредиты — их хватит, чтобы несколько десятков раз запустить playground до начала списаний.
- 02
Отправьте предсказание
Отправьте входные данные в формате JSON методом POST на https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video. Эндпоинт сразу возвращает id предсказания — генерация асинхронная, поэтому соединение не нужно держать открытым на время инференса.
- 03
Опрашивайте до завершения
Выполняйте GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. При статусе completed забирайте результат; при failed, cancelled, timeout или deleted остановитесь с ошибкой; при любом другом статусе продолжайте опрос.
- 04
Получите URL результата
Когда статус станет "completed", возьмите URL из data.outputs[0]. Он указывает на созданный файл в CDN WaveSpeedAI — изображение, видео, аудио или 3D-файл, в зависимости от вызванного варианта FLUX 3.
Сценарии применения
Что можно создать с FLUX 3
Типичные сценарии, для которых разработчики и авторы используют API FLUX 3.
Text-to-video с синхронизированным звуком по желанию
Создавайте кинематографичные клипы от 5 до 20 секунд прямо из промптов с управляемым действием, направлением камеры и композицией, в 720P или 1080P и с синхронизированным звуком по желанию.
Image-to-video с сохранением героя
Анимируйте обязательное исходное изображение: промпт задаёт движение, работу камеры и визуальный стиль, а начальную композицию не нужно воссоздавать с нуля по тексту.
Переходы между начальным и конечным кадром
Задайте обязательные начальное и конечное изображения, чтобы получить управляемый переход между утверждёнными ключевыми кадрами; промпт описывает действие, траекторию камеры, стиль и непрерывность движения.
Продление готового видео
Продолжите входное видео новым клипом длиной от 5 до 20 секунд. Опишите следующее действие, движение камеры и визуальное направление — FLUX 3 перенесёт движение в продолжение.
Процесс с Draft на первом этапе
Проверяйте направление промпта, исходные кадры и движение на конечной точке Draft по сниженной цене, а затем передайте утверждённые входные данные на соответствующую стандартную конечную точку для результата в 720P или 1080P.
Апскейл видео и восстановление деталей
Улучшайте MP4 с восстановлением деталей, верным исходнику или творческим, и настраиваемым масштабом от 1,5x до 3x — для реставрации, публикации в соцсетях и продакшен-экспорта.
Советы
Советы по написанию запросов для FLUX 3
Практические советы, как получать лучшие результаты от FLUX 3, — на основе приёмов, которые работают в продакшен-пайплайнах для моделей видео.
- 01
Выбирайте конечную точку по исходному материалу
Text-to-video — для кадра только по промпту, image-to-video — когда первый кадр утверждён, start-end-to-video — когда зафиксированы оба граничных кадра, video-extend — когда новый клип должен продолжать готовый материал.
- 02
Прототипируйте на Draft до финального рендера
Варианты Draft есть для text-to-video, image-to-video, start-end-to-video и продления видео. Сначала проверьте направление промпта, исходные кадры и движение, а затем передайте утверждённые входные данные на соответствующую стандартную конечную точку.
- 03
Описывайте движение и работу камеры отдельно
Сначала укажите, что делает герой, затем опишите движение камеры, крупность плана и темп. Явное разделение действия и операторской работы даёт модели более чёткий временной план для клипа от 5 до 20 секунд.
- 04
Используйте начальный и конечный кадр для управляемых переходов
Когда начальная и конечная композиции уже утверждены, передайте оба изображения и сосредоточьте промпт на переходе: движении героя, траектории камеры, изменении окружения и том, как должен быть достигнут финальный кадр.
- 05
Увеличивайте после утверждения творческого направления
Используйте video-upscale после утверждения тайминга, движения и композиции. Выбирайте восстановление, верное исходнику, когда важно сохранить вход, или творческое восстановление деталей, когда исходнику не хватает текстуры.
Цены
Цены на API FLUX 3
Оплата — за каждый результат. Итоговая стоимость зависит от параметров, заданных в playground каждого варианта (разрешение, длительность, количество результатов, референсы).
| Эндпоинт | Тип | Цена от |
|---|---|---|
| black-forest-labs/ | video-to-video | $0.03 |
| black-forest-labs/ | upscale-video | $0.79 |
| black-forest-labs/ | image-to-image | $0.05 |
| black-forest-labs/ | text-to-image | $0.05 |
| black-forest-labs/ | video-extend | $0.12 |
| black-forest-labs/ | text-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | image-to-video | $0.06 |
| black-forest-labs/ | text-to-video | $0.17 |
| black-forest-labs/ | video-extend | $0.41 |
| black-forest-labs/ | image-to-video | $0.17 |
| black-forest-labs/ | image-to-video | $0.17 |
API
Вызов API FLUX 3
Получите API-ключ на wavespeed.ai/accesskey, затем отправьте предсказание через REST. Playground генерирует готовые к вставке примеры для любой комбинации входных данных.
POSThttps://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "9:16",
"resolution": "720p",
"duration": 5,
"generate_audio": True
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Сравнение
FLUX 3 и альтернативы
Когда стоит выбрать FLUX 3, а не похожие модели в WaveSpeedAI.
FLUX 3 и Seedance 2.5
FLUX 3 предлагает процессы для текста, изображений, начального и конечного кадра и продления клипов от 5 до 20 секунд, а также конечные точки Draft и апскейла. Seedance 2.5 поддерживает клипы до 30 секунд, более крупные наборы референсов и отдельное редактирование видео. Выбирайте по исходным материалам и процессу, а не считайте эти API взаимозаменяемыми.
FLUX 3 и Veo 3.1
Оба семейства поддерживают видео по промпту, включая варианты со звуком. FLUX 3 дополнительно предлагает переходы между начальным и конечным кадром, итерации на Draft, продление и апскейл видео в одном семействе работающих конечных точек.
FLUX 3 и Sora 2
FLUX 3 предлагает отдельные конечные точки text-to-video, image-to-video, по начальному и конечному кадру, продления, Draft и апскейла для клипов от 5 до 20 секунд. Перед выбором семейства сравните требуемый формат исходника, длительность и разрешение результата.
FAQ
FLUX 3 API — часто задаваемые вопросы
Цены, лицензия, интеграция — частые вопросы о запуске FLUX 3 в WaveSpeedAI.
Доступен ли FLUX 3 API в WaveSpeedAI?
Да. Девять конечных точек black-forest-labs/flux-3 работают в каталоге WaveSpeedAI: text-to-video, image-to-video, видео по начальному и конечному кадру, продление видео, итерации на Draft и апскейл видео.
Какую конечную точку FLUX 3 API выбрать?
Text-to-video — для работы только по промпту, image-to-video — чтобы анимировать одно исходное изображение, start-end-to-video — чтобы соединить два утверждённых ключевых кадра, video-extend — чтобы продолжить клип, вариант Draft — для более дешёвых итераций, video-upscale — для улучшения в 1,5x–3x.
Какую длительность и разрешение поддерживает FLUX 3?
Работающие стандартные конечные точки генерации и продления поддерживают клипы от 5 до 20 секунд в 720P или 1080P с синхронизированным звуком по желанию. Требования ко входным данным зависят от конечной точки: image-to-video требует исходное изображение, start-end-to-video — оба кадра, video-extend — входное видео.
Как интегрировать FLUX 3 API?
Используйте стандартный процесс предсказаний WaveSpeedAI: авторизуйтесь ключом API, отправьте POST с входными данными конечной точки на путь модели black-forest-labs/flux-3, затем опрашивайте возвращённый идентификатор предсказания, пока результат не будет готов. Актуальная схема запроса показана в playground и примерах кода на этой странице.
Что такое API FLUX 3?
FLUX 3 — модель генерации видео от Black Forest Labs, доступная как REST API в WaveSpeedAI. FLUX 3 API от Black Forest Labs доступен в WaveSpeedAI: конечные точки text-to-video, image-to-video, видео по начальному и конечному кадру, продление видео, Draft и апскейл видео. Создавайте клипы длиной от 5 до 20 секунд в 720P или 1080P с синхронизированным звуком по желанию через один готовый к продакшену API. Её можно вызывать программно или попробовать в playground по ссылке выше.
Как вызывать API FLUX 3?
Создайте аккаунт WaveSpeedAI, скопируйте API-ключ на странице /accesskey и отправьте POST на https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video с входными данными в JSON. Эндпоинт вернёт id предсказания. Опрашивайте эндпоинт результата примерно раз в 2 секунды, для долгих задач увеличивайте интервал и останавливайтесь на любом финальном статусе. Примеры для продакшена на Python / Node.js / cURL — выше.
Сколько стоит API FLUX 3?
FLUX 3 стоит от $0.03 за запуск. Точная стоимость зависит от заданных параметров (разрешение, длительность, количество результатов, референсы). Предпросмотр стоимости рядом с кнопкой «Сгенерировать» в playground показывает точную цену для ваших текущих данных.
Какие варианты FLUX 3 доступны?
В WaveSpeedAI доступно рабочих эндпоинтов FLUX 3: 12 — black-forest-labs/flux-3/video-edit, black-forest-labs/flux-3/video-upscale, black-forest-labs/flux-3/image-edit, black-forest-labs/flux-3/text-to-image, black-forest-labs/flux-3/video-extend-draft, black-forest-labs/flux-3/text-to-video-draft, black-forest-labs/flux-3/image-to-video-draft, black-forest-labs/flux-3/start-end-to-video-draft, и другие. У каждого варианта своя страница playground и свои цены.
Можно ли использовать результаты FLUX 3 в коммерческих целях?
Права на коммерческое использование определяются лицензией модели Black Forest Labs. Большинство моделей Black Forest Labs разрешают коммерческое использование результатов; краткое описание лицензии смотрите на странице playground каждой модели, а условия платформы — в Условиях использования WaveSpeedAI.
Зачем использовать FLUX 3 в WaveSpeedAI, а не напрямую?
Один API-ключ и один платёжный аккаунт для FLUX 3 И для 1000+ других ИИ-моделей от разных провайдеров. Без настройки SDK для каждого вендора, без отдельных лимитов, без переписывания интеграционного кода под каждого поставщика. Цены, как правило, на уровне прямого API Black Forest Labs или ниже.
Разработчик
О Black Forest Labs
Команда, стоящая за FLUX 3 и всей линейкой моделей Black Forest Labs в WaveSpeedAI.
Black Forest Labs создала семейство моделей изображений FLUX с открытыми весами. FLUX.2 [klein] предлагает конечные точки text-to-image и edit на 4B и 9B с повышенным реализмом, более чёткой отрисовкой текста и нативной поддержкой LoRA — экономичная альтернатива более крупным вариантам FLUX для конвейеров изображений с большим потоком.
Начните создавать с FLUX 3 в WaveSpeedAI
Бесплатные стартовые кредиты при регистрации. Один API-ключ для 1000+ ИИ-моделей от Black Forest Labs и всех остальных провайдеров.