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 金鑰呼叫多個變體,組合成多步驟的處理流程。
使用您呼叫其他 1,000+ 個 WaveSpeedAI AI 模型時相同的 API 金鑰、帳單帳戶與速率限制額度來執行 FLUX 3。無需另外設定供應商、無需各家 SDK、無需處理各家不同的速率限制 — 一次整合,涵蓋從文字轉圖片、文字轉影片,到音訊合成、3D 生成、放大與編輯的所有功能。
規格
FLUX 3 API 功能與上線狀態
開發者在選擇 API 前會查詢的模型專屬資訊:可用性、預期輸出長度、參考素材支援,以及目前可用的替代方案。
上線狀態
已上線
WaveSpeedAI 目錄已上線九個 FLUX 3 端點,可透過標準 REST 預測流程進行生成、延伸、Draft 迭代與影片放大。
影片時長
5-20 秒
可由文字、單張來源圖片、起始與結束圖片生成 5 至 20 秒的影片,或將現有影片接續延伸。
輸出
720P / 1080P
標準生成端點支援 720P 與 1080P 輸出,並可選配同步音訊。影片放大支援可自訂的 1.5x 至 3x 倍率。
迭代
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
提交 prediction
將您的輸入以 JSON 格式 POST 到 https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/text-to-video。端點會立即回傳 prediction id — 生成是非同步進行的,因此推論期間您不需要保持連線。
- 03
輪詢完成狀態
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。狀態為 completed 時回傳輸出;狀態為 failed、cancelled、timeout 或 deleted 時停止並回報錯誤;其他狀態則持續輪詢。
- 04
讀取輸出網址
當狀態為 "completed" 時,從 data.outputs[0] 讀取網址。該網址指向 WaveSpeedAI CDN 上您生成的媒體 — 依您呼叫的 FLUX 3 變體,可能是圖片、影片、音訊或 3D 檔案。
應用情境
您可以用 FLUX 3 打造什麼
開發者與創作者使用 FLUX 3 API 的常見工作流程。
文字轉影片,可選配同步音訊
直接以提示詞生成 5 至 20 秒的電影感影片,可控制動作、運鏡、構圖,輸出 720P 或 1080P,並可選擇搭配同步音訊。
圖片轉影片,維持主體連貫
為必填的來源圖片加入動態,並以提示詞引導動作、運鏡與視覺風格,無須再從文字重新建立起始構圖。
首尾幀轉場
提供必填的起始與結束圖片,即可在已確認的關鍵幀之間生成可控的轉場,並透過提示詞引導動作、運鏡路徑、風格與動態連貫性。
延伸現有影片
將輸入影片接續生成為新的 5 至 20 秒片段。描述接下來的動作、運鏡與視覺方向,FLUX 3 會將動態延續到後續畫面。
先用 Draft 的正式生產流程
先用 Draft 端點以較低成本測試提示詞方向、來源畫面與動態,再將確認過的輸入送至對應的標準端點,產出 720P 或 1080P 成品。
影片放大與細節重建
以忠於原片或創意式的細節重建來強化 MP4,並可自訂 1.5x 至 3x 的放大倍率,適用於影片修復、社群發佈與正式輸出。
技巧
FLUX 3 提示詞技巧
讓 FLUX 3 產出更好結果的實用建議 — 整理自在實際生產流程中,影片模型通用的有效做法。
- 01
依素材選擇端點
僅用提示詞的鏡頭請用文字轉影片;首幀已確認時用圖片轉影片;起始與結束畫面都已固定時用 start-end-to-video;新片段必須接續現有素材時用 video-extend。
- 02
先用 Draft 打樣,再進行正式渲染
文字轉影片、圖片轉影片、start-end-to-video 與影片延伸皆提供 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 提交 prediction。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 vs Seedance 2.5
FLUX 3 提供 5 至 20 秒的文字、圖片、首尾幀與延伸工作流程,另有 Draft 與放大端點。Seedance 2.5 則支援最長 30 秒的影片、更大的參考素材組合,以及專用的影片編輯。請依素材與工作流程選擇,而非將這些 API 視為可互換。
FLUX 3 vs Veo 3.1
兩個系列都支援以提示詞驅動的影片,並有可生成音訊的版本。FLUX 3 另外在同一組上線端點中提供首尾幀轉場、Draft 迭代、影片延伸與影片放大。
FLUX 3 vs 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.5x 至 3x 的畫質強化請用 video-upscale。
FLUX 3 支援哪些時長與解析度?
已上線的標準生成與延伸端點支援 5 至 20 秒、720P 或 1080P 的影片,並可選配同步音訊。各端點的輸入需求不同:圖片轉影片需要來源圖片,start-end-to-video 需要起始與結束兩張畫面,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。端點會回傳 prediction 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 背後的團隊,以及 Black Forest Labs 在 WaveSpeedAI 上的完整模型陣容。
Black Forest Labs 打造了 FLUX 開放權重圖像模型系列。FLUX.2 [klein] 提供 4B 與 9B 的文字轉圖片及編輯端點,具有更強的寫實感、更清晰的文字渲染與原生 LoRA 支援,是較大型 FLUX 版本的高性價比替代方案,適合大量圖像管線。
在 WaveSpeedAI 上開始使用 FLUX 3 打造應用
註冊即贈免費入門點數。一組 API 金鑰,涵蓋來自 Black Forest Labs 與所有其他供應商的 1,000+ 個 AI 模型。