FLUX 3 API
Black Forest Labs FLUX 3 API 已在 WaveSpeedAI 上线,提供文生视频、图生视频、首尾帧视频、视频延长、Draft 草稿和视频放大端点。通过一个可用于生产的 API,生成 5 至 20 秒、720P 或 1080P 的视频片段,并可选配同步音频。
本 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 推出的视频生成模型,可通过 WaveSpeedAI REST API 使用。Black Forest Labs FLUX 3 API 已在 WaveSpeedAI 上线,提供文生视频、图生视频、首尾帧视频、视频延长、Draft 草稿和视频放大端点。通过一个可用于生产的 API,生成 5 至 20 秒、720P 或 1080P 的视频片段,并可选配同步音频。
本 FLUX 3 API 指南涵盖 WaveSpeedAI 上线的端点、价格、示例、集成流程、Draft 草稿变体以及生产级视频工作流。下方的 Playground、端点卡片、价格、示例和 API 示例代码均使用已上线的 black-forest-labs/flux-3 系列。
WaveSpeedAI 上的 FLUX 3 系列提供 12 个 REST 端点,涵盖 Video-To-Video, Upscale-Video, Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video 个工作流。每个变体都有各自的定价、参数选项和示例输出——请选择与你的输入模态和生产约束相匹配的那一个,或使用同一个 API 密钥调用多个变体,组合成多步骤流水线。
使用与 WaveSpeedAI 上其他 1,000 多个 AI 模型相同的 API 密钥、账单账户和速率限制来运行 FLUX 3。无需单独对接供应商,无需各家 SDK,也无需应对各家不同的速率限制——一次集成即可覆盖从文生图、文生视频到音频合成、3D 生成、放大和编辑的全部能力。
规格
FLUX 3 API 的能力与发布状态
开发者在选择 API 之前会搜索的模型细节:可用性、预期输出时长、参考素材支持情况,以及当前可用的在线替代方案。
可用性
已上线
WaveSpeedAI 目录中已上线九个 FLUX 3 端点,可通过标准 REST 预测流程完成生成、延长、Draft 迭代和视频放大。
视频时长
5-20 秒
可根据文本、单张源图像、首尾帧图像生成 5 至 20 秒的片段,或为现有视频生成新的续写部分。
输出
720P / 1080P
标准生成端点支持 720P 和 1080P 输出,并可选配同步音频。视频放大支持 1.5 倍至 3 倍的可配置倍率。
迭代
Draft 端点
文生视频、图生视频、首尾帧生视频和视频延长均有 Draft 变体,为提示词和运动迭代提供成本更低的途径。
端点
全部 FLUX 3 API 端点
WaveSpeedAI 现已提供 12 个 FLUX 3 端点——请选择适合你工作流的变体。
/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 的实际效果
由 FLUX 3 API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。
使用方法
如何使用 FLUX 3 API
从注册到完成一次生成,只需四步。完整的 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" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 FLUX 3 变体。
应用场景
用 FLUX 3 可以构建什么
开发者和创作者使用 FLUX 3 API 的常见工作流。
文生视频,可选同步音频
直接根据提示词生成 5 至 20 秒的电影感片段,可控制动作、运镜、构图,输出 720P 或 1080P,并可选配同步音频。
图生视频,保持主体连贯
为必填的源图像添加动态,用提示词引导运动、镜头移动和视觉风格,无需再用文字重建起始画面。
首尾帧转场
提供必填的首帧和尾帧图像,即可在已确认的关键帧之间生成可控的过渡,并通过提示词引导动作、镜头路径、风格和运动的连贯性。
延长现有视频
将输入视频续写为新的 5 至 20 秒片段。描述接下来的动作、镜头运动和视觉方向,FLUX 3 会把运动延续到新的片段中。
先 Draft 后正式的生产流程
先用 Draft 端点以较低成本测试提示词方向、源画面和运动,再把确认后的输入交给对应的标准端点,输出 720P 或 1080P 成片。
视频放大与细节重建
对 MP4 进行忠于原片或富有创意的细节重建,并可在 1.5 倍至 3 倍之间自由设置放大倍率,适用于修复、社交媒体发布和生产导出。
技巧
FLUX 3 提示词技巧
让 FLUX 3 输出更好结果的实用建议——总结自生产流水线中各类视频模型都适用的做法。
- 01
根据素材选择端点
仅用提示词的镜头使用文生视频;首帧已确认时使用图生视频;首尾两帧都已固定时使用首尾帧生视频(start-end-to-video);新片段必须续接现有素材时使用 video-extend。
- 02
正式渲染前先用 Draft 做原型
文生视频、图生视频、首尾帧生视频和视频延长均提供 Draft 变体。先验证提示词方向、源画面和运动,再把确认后的输入交给对应的标准端点。
- 03
把运动和镜头方向分开描述
先说明主体做什么,再描述运镜、景别和节奏。把动作和摄影语言都写清楚,能让模型为 5 至 20 秒的片段形成更清晰的时间规划。
- 04
用首尾帧实现可控转场
当开头和结尾的构图都已确认时,同时提供两张图像,并让提示词聚焦于过渡:主体运动、镜头路径、环境变化,以及如何到达最后一帧。
- 05
创意方向锁定之后再放大
在节奏、运动和构图确认之后再使用 video-upscale。需要忠于输入时选择忠于原片的重建;源视频需要额外纹理时选择创意细节重建。
定价
FLUX 3 API 定价
按输出计费。最终费用会随你在各变体 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
调用 FLUX 3 API
在 wavespeed.ai/accesskey 注册并获取 API 密钥,然后通过 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 与其他方案对比
在 WaveSpeedAI 上,何时应选择 FLUX 3 而不是同类模型。
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 提供明确的 5 至 20 秒文生视频、图生视频、首尾帧、延长、Draft 和放大端点。选择系列之前,请先比较所需的素材格式、时长和交付分辨率。
常见问题
FLUX 3 API — 常见问题
定价、许可、集成——关于在 WaveSpeedAI 上运行 FLUX 3 的常见问题。
WaveSpeedAI 上有 FLUX 3 API 吗?
有。WaveSpeedAI 目录中已上线九个 black-forest-labs/flux-3 端点,支持文生视频、图生视频、首尾帧视频、视频延长、Draft 迭代和视频放大。
应该使用哪个 FLUX 3 API 端点?
仅用提示词的流程使用文生视频;为单张源图像添加动态使用图生视频;连接两个已确认的关键帧使用首尾帧生视频(start-end-to-video);续写片段使用 video-extend;低成本迭代使用 Draft 变体;需要 1.5 倍至 3 倍增强时使用 video-upscale。
FLUX 3 支持什么时长和分辨率?
已上线的标准生成和延长端点支持 5 至 20 秒、720P 或 1080P 的片段,并可选配同步音频。各端点的输入要求不同:图生视频需要源图像,首尾帧生视频需要首尾两帧,video-extend 需要输入视频。
如何集成 FLUX 3 API?
使用标准的 WaveSpeedAI 预测流程:用 API 密钥进行认证,将对应端点的输入 POST 到 black-forest-labs/flux-3 模型路径,然后轮询返回的预测 ID,直到输出就绪。本页的在线 Playground 和代码示例展示了当前的请求结构。
FLUX 3 API 是什么?
FLUX 3 是 Black Forest Labs 的视频生成模型,在 WaveSpeedAI 上以 REST API 形式提供。Black Forest Labs FLUX 3 API 已在 WaveSpeedAI 上线,提供文生视频、图生视频、首尾帧视频、视频延长、Draft 草稿和视频放大端点。通过一个可用于生产的 API,生成 5 至 20 秒、720P 或 1080P 的视频片段,并可选配同步音频。你可以通过编程方式调用它,也可以在上方链接的 Playground 中试用。
如何调用 FLUX 3 API?
注册 WaveSpeedAI 账号,从 /accesskey 复制你的 API 密钥,然后把输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video。端点会返回预测 ID。从大约每 2 秒一次开始轮询结果端点,长耗时任务可适当拉长间隔,并在任何终止状态时停止。上方有面向生产环境的 Python / Node.js / cURL 示例。
FLUX 3 API 的费用是多少?
FLUX 3 每次调用 $0.03 起。实际费用会随你设置的参数(分辨率、时长、输出数量、参考素材)而变化。Playground 中“生成”按钮旁的实时费用预览会显示你当前输入对应的准确价格。
有哪些 FLUX 3 变体可用?
WaveSpeedAI 托管了 12 个已上线的 FLUX 3 端点: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 的服务条款。
为什么要在 WaveSpeedAI 上使用 FLUX 3,而不是直接对接?
一个 API 密钥、一个账单账户,即可使用 FLUX 3 以及来自其他提供方的 1,000 多个 AI 模型。无需逐家配置 SDK,无需应对各自独立的速率限制,也无需为每家重写集成代码。价格通常与 Black Forest Labs 直接提供的 API 持平或更低。
提供方
关于 Black Forest Labs
FLUX 3 及 WaveSpeedAI 上 Black Forest Labs 更多模型背后的团队。
Black Forest Labs 创造了 FLUX 系列开放权重图像模型。FLUX.2 [klein] 提供 4B 和 9B 的文生图及编辑端点,真实感增强、文字渲染更清晰,并原生支持 LoRA——是大批量图像流水线中较大 FLUX 变体的高性价比替代方案。
在 WaveSpeedAI 上用 FLUX 3 开始构建
注册即送免费体验额度。一个 API 密钥,即可使用来自 Black Forest Labs 及其他所有提供方的 1,000 多个 AI 模型。