邊界框版面 · 逐框編輯 · 原生 4K ● 可用

FLUX 3 Image API

Black Forest Labs 的 FLUX 3 Image 把生成控制推進到像素級：用邊界框為每個元素定位、按框局部編輯且未觸碰區域保持原樣，原生輸出 768sq 到 4K。Roko API 以非同步任務提供，768sq 每張 $0.041 起。

取得 API Key 查看完整 API 文件

公開模型 ID: flux-3-image
輸出檔位: 768sq / 1K / 1.5K / 2K / 4K（預設 1K）
計費方式: 按請求與所選解析度
生成接口: POST /v1/images/tasks
目錄快照: 2026/10/19 上午12:48:12

FLUX 3 Image 是什麼？

FLUX 3 Image 是 Black Forest Labs 於 2026 年 10 月 1 日發布的影像生成與編輯模型，官方口號是「控制每一個像素」。它的差異化能力是邊界框版面：把畫布抽象成 0 到 1000 的歸一化座標網格，在提示詞結尾為每個元素圈定範圍並配描述，生成結果會滿足這些位置約束。

編輯能力同樣按框進行：對成品圖的修改可以按框多輪完成，改過區域之外保持像素級不變，把局部重繪的誤差限制在框內。它還支援最多 10 張參考圖（在提示詞中按位置命名），以及 grounding 連網檢索增強。

Roko API 目前公開 768sq、1K、1.5K、2K、4K 五檔解析度和 16 種寬高比，按每次請求的所選解析度計費（768sq $0.041 至 4K $0.607）。核驗時數值與 BFL 標價相同，但 Roko 結算始終以目前專案目錄為準；呼叫走非同步任務，回傳 task_id 後輪詢結果。

核心能力

邊界框版面控制

用歸一化座標網格為每個元素定位再逐框描述，把生成從「描述得準不準」變成「版面定得對不對」。

逐框局部編輯

對成品圖按框多輪修改，未觸碰區域保持像素級不變，避免整體漂移。

10 張參考圖融合

組合最多 10 張參考圖，在提示詞中按位置命名，模型自行決定排布後整體渲染。

原生 4K 與 16 種寬高比

768sq 到 4K（約 16.8 百萬像素）五檔原生解析度，16 種寬高比，4K 放大後仍保留細節。

FLUX 3 Image API 價格

價格由目前 Roko 模型目錄生成，按每次請求的所選解析度計費。核驗時數值恰與 BFL 標價一致，但上游價格與促銷不決定 Roko 結算；請以提交時的 Roko 估價與最終帳單為準。

解析度	價格	計費單位
768sq	$0.041	每張輸出
1k	$0.048	每張輸出
1.5k	$0.07	每張輸出
2k	$0.1	每張輸出
4k	$0.607	每張輸出

費用怎麼算？

生成 1 張 1K 圖1 × $0.048 = $0.048

預設檔位，網頁與社群素材的標準成本。

4K 印刷級成稿1 × $0.607 = $0.607

原生最高檔，適合印刷與大幅輸出；每張按請求計費，失敗請求不計費。

參數與支援範圍

以下欄位來自目前公開 generation_config。邊界框語法寫在提示詞結尾（0–1000 歸一化座標）；表單之外的能力以實際請求驗證為準。

參數	可用值	說明
`prompt`	textarea	描述要產生的畫面，或說明要對參考圖做哪些修改。 · 必填
`images`	url / base64 · 1–10	參考圖可使用 URL 或 Base64；數量上限以目前模型參數範圍為準。 · 可選
`aspect_ratio`	auto / 21:9 / 2:1 / 16:9 / 3:2 / 7:5 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 5:7 / 2:3 / 9:16 / 1:2 / 9:21	選擇輸出寬高比；auto 交由模型依內容決定。 · 預設: auto · 可選
`resolution`	768sq / 1k / 1.5k / 2k / 4k	選擇目前模型設定的輸出解析度檔位；此值可能直接影響價格。 · 預設: 1k · 可選
`safety_tolerance`	0–4	Roko 目前開放 0–4：0 最嚴格，4 最寬鬆；預設 2。 · 預設: 2 · 可選
`grounding`	boolean	開啟後模型可連網檢索補充提示詞資訊；預設開啟。 · 預設: true · 可選

用 Roko API 呼叫 FLUX 3 Image

走非同步任務流程：提交任務拿到 task_id，再輪詢查詢結果。不要在前端程式碼中暴露 API Key。

發起圖片生成

curl https://api.rokoapi.com/v1/images/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "flux-3-image",
  "prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
  "aspect_ratio": "16:9",
  "resolution": "1k"
}'

查詢恢復任務

curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
  -H "Authorization: Bearer $API_KEY"

POST /v1/images/tasks 回傳 202 與 task_id，生成完成後透過 GET /v1/tasks/{task_id} 查詢結果或失敗原因。Idempotency-Key 需唯一；相同 Key 的重放會回傳原任務而不重複計費。

適合哪些場景？

精確構圖的版面與海報

標題、主體和背景元素的位置都能按框約束，適合廣告版面和海報排版。

Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.

多輪局部精修

按框逐次修改，改過的區域之外保持像素不變，適合反覆確認的成稿流程。

Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.

多參考圖場景合成

把人物、產品、場景等多張參考圖融合進一張按框版面的圖。

Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.

4K 印刷與大幅輸出

原生 4K（約 16.8 百萬像素）輸出放大後仍保留細節，適合展板與印刷物料。

Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.

使用前要知道的限制

按每次請求計費，4K 檔 $0.607 明顯高於低檔位；大量草稿迭代建議用 768sq 或 1K。
邊界框使用 0–1000 歸一化座標並寫在提示詞結尾；框的語法錯誤會按普通文字處理或被請求驗證拒絕。
Roko 目前將 safety_tolerance 限定為 0–4（0 最嚴格、4 最寬鬆），預設 2；調高前請確認符合適用條款。
非同步任務提交成功不等於生成成功，以任務查詢結果為準；生成結果仍需人工複核後使用。

FLUX 3 Image 與其他圖像模型怎麼選？

需要精確版面與逐框編輯選 FLUX 3；Seedream 系列適合中文場景與組圖；GPT Image 2.5 適合透明背景與日常內容。按控制粒度、解析度與價格權衡。

全部模型 →

FLUX 3 Image 常見問題

FLUX 3 Image API 的模型 ID 是什麼？

Roko API 目前公開模型 ID 是 flux-3-image。請原樣傳入 model 欄位。

FLUX 3 Image API 多少錢？

按每次請求的所選解析度計費：768sq $0.041、1K $0.048、1.5K $0.07、2K $0.10、4K $0.607。核驗時數值與 BFL 標價相同，但 Roko 結算以提交時的專案估價與最終帳單為準。

邊界框版面怎麼用？

官方方案是把畫布按 0 到 1000 歸一化，在提示詞結尾為每個元素寫一個邊界框和描述，例如「fountain (400,500)-(600,800)」。生成結果會滿足這些位置約束。

逐框編輯是什麼意思？

對已生成的圖按框修改：只有框內區域被重繪，框外保持像素級不變，可以多輪進行，避免整圖漂移。

支援哪些解析度和寬高比？

Roko 目前公開 768sq、1K、1.5K、2K、4K 五檔和 16 種寬高比（預設 auto）。4K 約 16.8 百萬像素，屬原生輸出而非放大。

FLUX 3 Image 透過哪個接口呼叫？

透過 POST /v1/images/tasks 提交非同步任務並拿到 task_id，再用 GET /v1/tasks/{task_id} 輪詢結果或失敗原因。

grounding 參數是做什麼的？

grounding 開啟後模型可連網檢索來補充提示詞資訊（如即時事實或品牌素材描述），預設開啟；不需要時可顯式關閉。

開源權重可以直接用嗎？

截至最近核驗（2026-10-06），BFL 官方表示開放權重版本將在未來幾週推出，商業權重需另行聯繫取得；Roko 上使用的是 BFL 官方 API 通道。