Solutions Choose your path
For individuals Build, learn, and create with simple usage-based access. For business Scale teams, billing, governance, and model workflows. More English 繁體中文 日本語 한국어 Français Deutsch Español Italiano Português Русский العربية ไทย Tiếng Việt Bahasa Indonesia Bahasa Melayu Türkçe Polski Nederlands Danish Norsk Қазақ اردو
免費開始 免費開始
500+ AI Model API, All In One API.
Just In CometAPI © 2026 CometAPI · All rights reserved
Home Blog 如何使用 FLUX 3 Image API 與 CometAPI
guide / CometAPI 研究
如何使用 FLUX 3 Image API 與 CometAPI 在 CometAPI 上使用 FLUX 3 Image 進行生成與編輯。了解影像參數、非同步作業處理、提示詞範例與定價。
Deon Goodwin AI 模型與 API 研究團隊 在 CometAPI 上使用 FLUX 3 Image 進行生成與編輯。了解影像參數、非同步作業處理、提示詞範例與定價。
先用這個摘要快速掌握答案，再閱讀指南取得背景、範例與實作細節。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_COMETAPI_KEY",
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="gpt-5-mini",
messages=[{"role": "user", "content": "Build this workflow."}],
)
print(response.choices[0].message.content)重點摘要
使用 FLUX 3 Image 建構產品照片、海報與基於參考的編修，透過 CometAPI 以 flux-3-image 提供，價格自每次請求 $0.0384 起。本指南帶你完成影像設定選擇、準備請求、處理非同步工作，以及檢閱完成的影像。你需要 CometAPI 帳號、API 金鑰，以及為你的帳號提供的 FLUX 3 Image 請求設定。
關鍵重點
新創作選擇文字到影像；當必須保留產品或主體可辨識性時，選擇參考引導的編修。
先以小尺寸草稿檢視構圖，再投入較大尺寸的最終圖像成本。
使用 CometAPI 憑證與該模型的請求結構；BFL 原生金鑰與範例屬於另一套整合。
依 CometAPI 適用費率估算成本，並以每個被採納成品衡量支出。
在跑批前，先完成一次提交、結果擷取、下載與視覺檢查。
什麼是 FLUX 3 Image API？
FLUX 3 Image 是 Black Forest Labs 的靜態影像生成與修圖模型。文字提示描述新場景；參考影像提供需保留、結合或變更的視覺素材。對電商團隊而言，這可能意味著先從簡報開發一張產品場景，再在變換環境的同時重用已核准的產品照片。
在撰寫提示前先選擇工作流程。若為新視覺，請指明主體、場景、光線與取景；若為編修，請指出來源影像、想要的變更，以及必須保持不變的細節。若為多參考合成，請為每張參考指定角色，避免產品識別與視覺風格互相競合。
FLUX 3 Image 規格與 API 參數 模型身份 FLUX 3 Image；型錄 ID 為 flux-3-image 使用帳號範例中的模型專用路由與路由慣例。 生成／提示 場景、構圖或編修指令 以一個清楚的主體與一個預期輸出為起點。 參考影像／原生 images 1–10 張參考影像的有序清單，於原生 API 中以 HTTP(S) URL 或 base64 提供。 確認閘道的欄位名稱、輸入格式與參考數量上限。 畫面比例／原生 aspect_ratio 畫布長寬比。auto 時，提示中請求的比例將優先；否則編修會保留第一張參考的取景。 依交付格式選擇比例並確認可接受的值。 解析度／原生 resolution 原生等級：768sq、1k（預設）、1.5k、2k、4k。確切尺寸取決於畫面比例。 對於編修，match_input 會保留第一張參考的尺寸，若更大則降至 4 MP；明確指定 aspect_ratio 會選擇其最近的等級。明確的 width 與 height 具有最高優先權。 精確尺寸／width + height 同時提供兩個整數，介於 256–6256 像素。它們會覆寫 resolution 與 aspect_ratio。總像素上限為 16,822,272；使用參考影像時上限為 4,194,304。 需要固定交付尺寸時使用明確尺寸，例如 1024 × 1280。確認你的 CometAPI 路由是否接受這些原生控制。 版面控制 以邊界框指導元素放置位置 在需要精確放置時，使用文件所述的版面語法。 目標式編修 僅針對選定主體或區域進行變更 比對應保持不變的區域之來源與結果。 驗證 CometAPI API 金鑰用於閘道請求 依 CometAPI 範例使用驗證標頭；將金鑰保留在伺服器端。 結果處理 非同步生成：提交工作、追蹤其 task ID、擷取完成影像 當你的帳號路由遵循 CometAPI FLUX 任務合約時，使用下方 Python 範本。 價格 CometAPI 定價自每次請求 $0.0384 起（2026 年 11 月 9 日）。 以下方價格區段做示範性預算；請驗證你選擇的設定。
以三種方式其一來選擇尺寸：resolution 等級加上畫面比例、width 加 height 的精確畫布，或在編修中使用 match_input。保留原始參考，以便在生成後比較取景與細節。原生端點會拒絕不支援的欄位；請依你呼叫的路由結構提交。
FLUX.2 vs FLUX 3 Image 使用情境 強大的文字轉圖／編修、家族變體 細緻的影像構成與像素保真編修 比較同品牌的提示 解析度 依變體而異的高解析生成 明確的 2K／4K 原生展示 以全尺寸檢視微細細節 編修 部分變體具備多參考能力 在地化（區域）編修示範 衡量未編修區域的漂移 成本 隨變體與平台不同 依選擇的設定使用 CometAPI 定價 以每個被採納影像比較 CometAPI 存取 透過 CometAPI 提供 FLUX 2 PRO 與 FLUX 2 MAX 透過 CometAPI 提供為 flux-3-image 在變更生產路由前驗證模型專用請求 評估 以當前部署的確切變體為準 跑同一提示與參考組 比較可接受輸出與整體工作流程成本
在評估 FLUX 3 Image 時，保留既有的 FLUX.2 整合作為基準。將相同的簡報與參考資產同時走兩種流程，然後比較被採納的輸出、周轉時間與總成本。
1. 先決條件 export COMETAPI_KEY="your_cometapi_key"
2. 端點 POST https://api.cometapi.com/flux/v1/flux-3-image
驗證採用 Bearer token（CometAPI 風格）。請求預設為「非同步」。
3. 基本文字轉影像範例（cURL） curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
{
"id": "<task_id>",
"status": "Pending",
"result": {},
"polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}
4. 輪詢結果 curl "https://api.cometapi.com/flux/v1/get_result?id=<task_id>" \
-H "Authorization: Bearer $COMETAPI_KEY"
持續輪詢直到 status 為 "Ready"。影像 URL 會出現在 result.sample（請迅速下載；簽名 URL 具時效性）。
若要在同一請求中同步等待，請在 body 加上 "async": false（連線需保持開啟；用較寬鬆的客戶端逾時設定）。
5. Python 範例（提交＋輪詢） import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image 支援純文字轉圖與編修／多參考，且使用同一端點——只要包含 images 並在提示中描述如何使用它們（不需獨立的「mode」欄位）。
替代方案：相容 OpenAI 的路由 你也可以試用統一的 images 端點與模型 ID：
POST https://api.cometapi.com/v1/images/generations
{
（若需完整的 FLUX 3 參數，建議使用原生的 `/flux/v1/...`。）
### 提示
* 查看 [CometAPI Flux 3 Image 模型頁](https://www.cometapi.com/models/flux/flux-3-image/)以確認目前可用性與精確定價。
* 請儘速下載 `result.sample` URL。
* 最新參數清單或試玩範例請參考 CometAPI 的 Flux 文件與 Black Forest Labs 官方 FLUX 3 Image 參考。
此流程鏡像官方 BFL 的操作，但使用 CometAPI 的驗證與統一基礎設施。
## 如何為 FLUX 3 Image 撰寫提示？範例
### 範例：產品攝影提示
使用此提示做第一次產品攝影測試。
A premium amber perfume bottle centered on matte limestone,
將 request.json 中的 prompt 值替換為此簡報，同時保持你的 CometAPI 路由所預期的請求 body。不論你的路由是否接受原生尺寸控制，4:5 畫布適合直式產品擺放；若可用精確尺寸控制，1024 × 1280 是精確的 4:5 選項，請一併提供兩個值。
先以小尺寸草稿檢查瓶身輪廓、標籤、反射與額外物件。若產品識別至關重要，請使用產品參考，而非期待純文字能精準重現。變更前請記錄提示與輸出設定。
### 範例：字體排印與海報版面
具明確標題文字的海報提示。
An editorial art poster on warm off-white paper.
將此簡報用作 CometAPI 請求中的提示，並選擇直式畫布。先以草稿檢查標題位置與角色編排，再將輸出尺寸放大以產出最終作品。
將字母準確度視為可量測的驗收條件。在最終解析度的輸出中逐字檢閱字母與標點；即使展示圖令人印象深刻，也不保證你的品牌文字零錯誤。
## 如何使用參考影像進行編修
對於編修，同時描述你要的變更與需保留的細節。原生 FLUX 3 Image API 以 images 接收參考影像；在你的 CometAPI 範例中對應至相應的輸入欄位。將產品參考置於第一順位，並在提示中保持此順序一致。
### 單張影像編修：更換背景，保留產品
將 edit.py 與 submit.py、poll.py、download.py 放在一起。設定 PRODUCT_IMAGE_URL 為一張可公開存取的 HTTPS 產品照片，然後執行 python edit.py。下例需要可接受原生 images 陣列的路由。使用不含衝突來源影像欄位的編修請求 body；若你的 CometAPI 範例使用不同輸入欄位，請調整對應。要續跑已保存的編修任務，執行 python poll_download.py editing-task.json。
import json
This request variant requires a route accepting the native images array. payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
選擇一張清晰、標籤可讀、輪廓明確的產品照。依你的 CometAPI 路由所接受的影像輸入格式提交。若該路由支援原生 resolution 設定，使用 match_input 以保留參考的取景與尺寸（受模型編修限制）。
[BFL 畫廊](https://bfl.ai/models/flux-3-image) 展示了以新增兩位潛水員為例的在地化編修。這些官方前後對照素材示範了檢查重點；它們並非本文章以 CometAPI 請求執行所產生的輸出。
BFL 官方編修範例，前：原始水下場景，只有一位潛水員。
BFL 官方編修範例，後：新增兩位潛水員。請同時檢查未變更的背景與新增主體。
### 多影像參考編修：結合風格與產品識別
將產品放第一，將光線／風格參考放第二。設定 PRODUCT_IMAGE_URL 與 STYLE_IMAGE_URL，將下列程式碼儲存為 multi_edit.py 並置於三個用戶端檔案旁，執行 python multi_edit.py。此範例需要能在 images 中接受至少兩個參考的路由。以不含衝突來源影像欄位的編修請求 body 起步。要續跑已保存的工作，執行 python poll_download.py multi-edit-task.json。
import json
Preserve this order: product first, lighting/style second. payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
使用模型專用的 CometAPI 格式附上兩個參考。先檢查產品是否保留了識別；再評估第二個參考是否帶來預期的光影與色彩。若同時引入不需要的物件或文字，請簡化該參考或在提示中更明確。
## 如何使用邊界框進行版面控制
當瓶身與標題需要佔據可預期區域時，請使用邊界框。撰寫一段帶有每個元素 ID 的場景說明，然後在提示後附上一個 JSON 陣列。BFL 的格式使用 bbox，順序為 [top, left, bottom, right]，座標系為 0–1000；方框屬於提示的一部分，而不是獨立的 API 欄位。
下例在瓶身上方保留標題空間。請在 request.json 中保持直式輸出設定，並將此檔案存為 layout.py 與 submit.py 放在一起。執行 python layout.py，接著執行 python poll_download.py layout-task.json。請使用支援此版面語法的路由；檢查結果中瓶身與標題是否落在預期區域。
import json
caption = (
保持畫面比例與版面一致。方框提供放置引導，而非將物件硬性裁切至邊界內。請檢查輸出影像中的標題拼字與字距；若需精確字體呈現，建議在設計工具中加入最終品牌字樣。
## FLUX 3 Image API 要花多少錢？
CometAPI 提供的 FLUX 3 Image 自[每次請求 $0.0384 起](https://www.cometapi.com/models/flux/flux-3-image/)（2026 年 11 月 9 日）。以此起始費率作為初步預算，接著依你選擇的設定採用實際費率。下列範例假設每筆計費請求皆使用起始費率。
| 計費請求數 | 假設費率／每請求 | 示意成本 |
| ---------- | ---------------- | ----------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
在提交批次前，請先確認你帳號與所選設定的實際費率。公開起始價格不代表所有解析度或編修選項的價格。請同時追蹤被拒絕的創作嘗試與被採納的輸出：若你在 100 次計費請求花費 $3.84，且採納 80 個成品，則每個被採納成品的 API 成本為 $0.048，尚未包含人工審核與儲存。此為示意計算，非實測之接受率。
### 依工作流程選擇解析度
| 工作流程 | 首次測試 | 核准檢查 |
| --------------------------- | -------------------------------- | ------------------------------------------ |
| 提示探索 | 最小但仍具實用性的支援等級 | 構圖與主體位置 |
| 電商產品影像 | 以預期裁切的草稿 | 產品幾何、標籤與邊緣細節 |
| 行銷或編輯類藝術作品 | 先出草稿；版面核准後再放大輸出 | 在交付尺寸檢查字體與細節 |
| 基於參考的編修 | 適合來源的支援設定 | 未變更區域、產品識別與光線 |
## 何時應該改用 FLUX 3 Video？
FLUX 3 Image 適用於靜態資產，如產品主視覺、海報或活動畫面。若交付物需要動態，請參考 [CometAPI 上的 FLUX 3 Video](https://www.cometapi.com/models/flux/flux-3/)，其模型 ID 為 flux-3。其[影片工作流程](https://apidoc.cometapi.com/api/video/flux-3/create)使用影片專屬的設定與計費。請將影像與影片請求分開；時長、音訊與逐格控制不適用於靜態影像請求。
若同一檔期同時需要兩種格式，請先核准靜態影像的構圖，再分別準備動態簡報。重用已核准影像作為來源前，請檢查影片模型的參考輸入需求。
## 結論
從一則產品簡報與一個小尺寸影像工作開始。透過你的 CometAPI FLUX 3 Image 路由提交，保存 task ID，擷取完成影像並檢視結果，再逐步擴大規模。需要精確畫布時使用 width 與 height；在支援的情況下，編修可用 match_input。以被你採納的影像數對照總支出，讓預算反映可用成果。
## SEO 中繼資料
Meta title: FLUX 3 Image API 指南：生成、編修與 CometAPI
Meta description: 在 CometAPI 上使用 FLUX 3 Image 進行生成與編修。了解影像參數、非同步工作處理、提示範例與每次請求自 $0.0384 起的定價。
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, FLUX 3 影像編修, FLUX 3 定價, 參考影像生成, FLUX.2 遷移
URL slug: flux-3-image-api-guide
原生 FLUX 3 Image 接受 width 與 height。請勿沿用舊模型的 seed 或 input_image；原生參考輸入使用 images，並依 CometAPI 閘道結構提交。
