FLUX 3 Image 允許你在影像提示中使用矩形描述各元素的位置。同一套系統也能編輯參考圖片：每個元素都可指定來源位置、目標位置，以及要如何修改的描述。Black Forest Labs 在 10 月 1 日將影像端點加入其 10 月 1 日的發布說明。
對設計師和創作者來說，重要的是分清楚規劃完整構圖，與修改既有圖片中的元素。本文說明如何選擇做法、將矩形換算為所需座標，以及如何取得 API 結果。這是依據文件撰寫的指南，資料查核日期為 2026 年 10 月 3 日。BIG CHANGE 並未使用此產品生成或編輯圖片。
重大改變
- 改變了什麼： BFL 10 月 1 日的發布文件說明，如何透過
v1/flux-3-image進行構圖與編輯。場景描述和 JSON 元素表格會放在同一個提示中，以方框指定位置或編輯內容。 BFL 發布說明 - 為何重要： 創作者可把規劃好的矩形換算成座標，再指定參考圖片中要保留、移動或替換的元素。實際要拿捏的是描述的細節程度：完整構圖、簡單指令，或明確的編輯表格。 BFL 方框教學
- 觀察重點： 提交前先選定解析度並估算預算：列出的
1k和4k價格為每張圖片 0.048 美元和 0.607 美元。請檢視完整結果，因為內容可能超出方框，編輯也可能影響周圍的光線、陰影或反射。 BFL 價格、 編輯限制
選擇瀏覽器或 API 操作方式
BFL 的 產品頁面 介紹兩種入口：在瀏覽器 Playground 中繪製方框，或透過 API 傳送版面提示。其 文件提供 Playground 連結 可供無程式碼使用。若要直接繪製區域，請使用瀏覽器流程；若需在請求中提供座標並以程式擷取輸出，則使用 API。我們未檢查 Playground 目前的控制項，因此下文說明的是文件所載的請求格式，而非逐步操作瀏覽器按鈕的流程。
若要使用 API，請建立 BFL 帳戶、儲值，並從 控制台取得金鑰。使用 POST 請求傳送至 https://api.bfl.ai/v1/flux-3-image，並使用 Content-Type: application/json 以及位於 x-key 標頭中的金鑰。只有 prompt 是必填欄位。 BFL 生成指南、 價格與設定
必須區分 FLUX 3 Image 與 FLUX 3 Dev：本文說明的是 BFL 託管的 Image 端點。Image 產品頁提供商用權重授權，需洽業務部門。本文查核的來源並未證明 FLUX 3 Image 有開放權重可下載。 FLUX 3 Image 存取方式
決定要描述多少影像細節
任務 | 文件所載輸入 | 要使用的控制項 |
|---|---|---|
生成新構圖 | 場景提示，可選擇加上元素表格 | |
修改可辨識的細節 | 指令和一張參考圖片 | 精確描述可能就足夠；請檢查擴展後的提示 |
精確指定要編輯的元素 | 指令、參考圖片和編輯表格 | 來源方框和目標方框；要保留的元素使用 keep 列 |
組合參考圖片 | 說明各圖片用途的提示，以及 2 到 10 張圖片 | 指出各圖片分別提供哪個主體、物件或場景 |
BFL 表示，簡單編輯可在提示擴展時自動取得方框。若需明確控制，請自行提供表格。一般指令中的「image 1」代表第一張參考圖片；在編輯列中，同一張參考圖片則是 ref_image_0。 BFL 編輯指南
參考圖片可用網址或 base64 資料放在 images 中，可使用字串或清單。提供圖片時，數量可為 1 至 10 張，每張解析度須介於 256 × 256 像素至 1,600 萬像素。預設 aspect_ratio 是 auto：它會沿用第一張參考圖片的比例；若未提供參考圖片，則使用正方形。若版面需要特定形狀，請明確設定。 BFL 端點總覽
將矩形換算為方框
每個方框都是 [top, left, bottom, right]，座標使用 0 到 1000 的整數。垂直座標列在前。每個軸都獨立涵蓋整張圖片，因此格線會隨橫向或直向畫布伸縮。 BFL 方框格式
像素位置換算方式：上緣和下緣除以圖片高度，左緣和右緣除以圖片寬度。各結果再乘以 1000 並四捨五入。BFL 文件以 1920 × 1080 畫布示範換算：
邊界 | 像素位置 | 計算式 | 格線數值 |
|---|---|---|---|
上 | 108 | 108 ÷ 1080 × 1000 | 100 |
左 | 384 | 384 ÷ 1920 × 1000 | 200 |
下 | 972 | 972 ÷ 1080 × 1000 | 900 |
右 | 1536 | 1536 ÷ 1920 × 1000 | 800 |
因此，這個方框是 [100, 200, 900, 800]。它的垂直範圍為畫面的 10% 到 90%，水平範圍為 20% 到 80%。這項計算說明，調換寬度與高度，或把左側座標放在上方座標之前，都會改變預期區域。請維持設計版面時使用的長寬比。 BFL 座標換算
構圖：生成新圖片
撰寫完整構圖描述，並以 <id> 標記元素。接著附上 JSON 陣列，為每個元素提供 id、 bbox 和 desc 等欄位。此陣列是 prompt中的文字，而非另一個頂層 API 欄位。
BFL 文件所載的奔跑剪影範例，背景涵蓋整個畫布，人物位於中央方框。以下簡化請求沿用該版面；BIG CHANGE 並未執行：
{
"prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
"aspect_ratio": "1:1",
"resolution": "1k"
}若版面包含文字，請為每一行各設一列，並將要求的確切文字放在 desc中。方框會引導位置和尺寸；BFL 提醒，元素可能延伸到矩形之外。它們並非硬式裁切遮罩。 BFL 構圖教學與限制
編輯既有圖片
將來源放入 images。編輯列會保留 id 與 desc ，並將 bbox 替換成以下欄位：
操作 | | | |
|---|---|---|---|
保留元素 | | 來源方框 | 相同方框 |
移動或調整尺寸 | | 來源方框 | 另一個目標方框 |
新增、替換或改變顏色 | | | 目標輸出方框 |
移除元素 | | 來源方框 | |
將指令和編輯陣列合併在 prompt中，方式與構圖相同。新增或移除內容都要在兩處描述。要保留原位的元素請加入 keep 列。BFL 指南表示，方框以外的像素通常不變，但周圍光線、反射和陰影仍可能改變。接受編輯前，請將完整輸出與來源圖片比較。BFL 也指出，在自家測試中，約 40 × 25 像素方框內的新元素常未能出現；這是供應商觀察，不代表普遍適用的最低尺寸，也不是 BIG CHANGE 的測試。 BFL 編輯說明、 編輯列結構
選擇解析度和預算
總覽列出 768sq、 1k、 1.5k、 2k 和 4k，其中預設值是 1k 。價格頁公布以下費率，但沒有列出 1.5k 的價格。使用前請先確認該選項的費用。 BFL 總覽
解析度 | 文件記載的輸出尺寸 | 每張圖片價格 | 十次請求的計算金額 |
|---|---|---|---|
| 768 × 768 | $0.041 | $0.41 |
| 約 1 百萬像素 | $0.048 | $0.48 |
| 約 4 百萬像素 | $0.100 | $1.00 |
| 約 1,600 萬像素 | $0.607 | $6.07 |
以上是 BFL 列出的美元價格，於 10 月 3 日查核。十次請求欄是計算結果，並非實際支出。BFL 對 API 和 Playground 收取相同價格，每點數等於 0.01 美元。提交回應包含 cost。另外一個 4k 請求的列價約是 1k的 12.6 倍；請依任務需求選擇輸出尺寸，並為額外嘗試編列預算。更改解析度就會形成新請求；本指南無法證明兩次請求會產生相同構圖。 BFL 價格
選用的 grounding 設定預設為 true可在生成前啟用網頁與圖片搜尋。BFL 表示，關閉此功能後只依提示生成，速度會更快。我們未測量這項速度差異，也未驗證根據搜尋資料生成的結果是否準確。 BFL grounding 文件
提交、輪詢並儲存結果
提交後，請保留回傳的 polling_url ，並使用 API 金鑰輪詢該確切網址。它會指向保存任務的區域。 Pending、 Reasoning 和 Generating 表示任務仍在執行。狀態為 Ready時，請下載 result.sample；簽署連結會在一小時後到期。請勿將 x-key 標頭傳送至下載網址。結果還包含 result.prompt，用來顯示擴展後的指令；以及 result.duration，也就是生成所花時間。 BFL 結果擷取說明
遭封鎖或失敗的任務，處理方式應不同於仍在執行的任務。 Request Moderated 代表輸入內容遭封鎖； Content Moderated 代表輸出遭封鎖。再次嘗試前請先調整輸入。若狀態為 Error，請檢查回應；若任務不存在或已過期，則會回傳 Task not found。BFL 提醒，失敗任務可能以 HTTP 503 回應傳回，但內文仍是一般 JSON，因此重試前請先讀取其中的 status 。參考圖片過大會產生 400；欄位名稱不明、值無效、提示為空或圖片過小，則可能產生 422。其他端點中的欄位，例如 seed、 width 與 input_image ，此端點都不接受。 BFL 生成與錯誤指南
只有在儲存輸出並檢查其位置、要求顯示的文字及編輯區周邊內容後，才算完成一次嘗試。收到 Ready 回應只表示結果已可取得；是否符合任務，仍要靠目視檢查判斷。
來源與延伸閱讀
- FLUX 3 Image 產品頁：說明瀏覽器與 API 使用方式，以及商用權重的取得方式。示範內容來自供應商，並非我們的測試結果。查核來源未能證明此 Image 端點提供開放權重下載。
- 10 月 1 日發布說明：記錄影像功能的發布日期並說明共用端點。解讀廣泛的控制能力宣稱時，也應同時參照教學文件列出的較具體限制。
- 端點總覽：列出參數、參考圖片限制、解析度選項與搜尋依據行為。
- 邊界方框教學：解說兩種列結構與本文改編的奔跑剪影範例。
- 編輯指南：說明座標換算、參考圖片順序，以及小區域和周圍像素的注意事項。
- 生成指南：說明驗證、非同步結果擷取、限時連結及錯誤。
- 價格：提供本文計算採用的費率。付費嘗試前請再次確認價格與請求參數，因為這些文件會更新。
