FLUX 3 Image Klein

快速範例

提交一次影像請求，保存回傳的 id，並輪詢直到任務為 completed 或 failed。此 API 使用非同步任務，以 URL 回傳輸出。

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

端點與請求標頭

POST https://api.seedrouter.ai/v1/images/generations

請將金鑰保存在伺服器端。HTTP 成功僅表示任務已受理，並不表示影像已就緒。

參數

接受 11 個欄位，只有 model 和 prompt 必填。省略選用欄位即可使用預設值；不接受 null。

比例：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。

Playground 固定模型，提供十個輸入控制項，包括固定為 1 的 n。大於 2 的安全值僅限 API，管理員除外。

模式與約束

無參考圖時為文生圖。一張參考圖用於編輯，多張參考圖用於融合構圖。使用 auto 時，編輯沿用第一張參考圖的長寬比。純文字生成根據提示詞選擇畫幅，無法確定時使用 1:1。所有模式的解析度預設均為 1k。

解析度級距表示影像的大致規模：768sq 約為 768 × 768；1K 約為 1 MP；1.5K 約為 2 MP；2K 約為 4 MP；4K 約為 16 MP。實際尺寸請檢查回傳檔案。

此端點不接受 width、height、size 中的像素尺寸、negative_prompt、guidance、grounding、prompt_upsampling、mask 或 mask_url。未知欄位會在計費前回傳 HTTP 400。不提供 WebP 輸出、base64 輸入、串流或回呼。

參考圖與區域編輯

提交前，將參考圖上傳至公開 URL。請求主體包含 URL，不包含檔案位元組或 data URL。

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

將預留位置的 URL 替換為你自己可存取的影像。參考圖按順序排列：ref_image_0 為第一張。邊界框指令屬於 prompt 字串，不是獨立的請求欄位。座標使用 [y1, x1, y2, x2]，正規化到 0–1000。版面物件可包含 id、bbox 和 desc；編輯可使用 id、from、src_bbox、tgt_bbox 和 desc。請對完整請求進行 JSON 編碼，正確跳脫提示詞中的引號。

計費

一次成功請求生成一張影像。價格僅由所選解析度決定；步數、種子、長寬比、參考圖數量和格式均不額外收費。文生圖與編輯費率相同。失敗的請求不收費。參見即時價格。

任務回應與輪詢

提交回應：

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

已完成任務（URL 僅作範例）：

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

讀取 output.data[0].url。請為生成預留最多十分鐘，尤其是 4K。輪詢為唯讀操作；用戶端逾時不代表可以再次提交付費請求。公開任務回應不包含費用或帳戶餘額。

錯誤

HTTP 錯誤使用 {"error": {"code": integer, "message": string}}。參見公共錯誤目錄。失敗任務會在 status: "failed" 旁提供錯誤資訊。重新提交前先修正無效參數；查詢已提交請求時保留任務 ID。

提示與相關指南

使用正面描述，明確需要保留的區域或細節。降低步數可能改變品質，但不會降低價格。每次只改變一個因素進行比較。

• FLUX 3 Image Klein Playground
• 下載、權重與 ComfyUI 指南
• 任務生命週期