Roko API
控制台
文生圖 · 參考圖編輯 · 最高 4K ● 可用

FLUX 3 Image API

Roko API 的 flux-3-image 目前透過 Kie AI 接入 FLUX 3 Klein：未提供參考圖時文生圖，提供圖片後自動切換影像編輯。支援 1K、2K、4K，每次可輸出 1–4 張。

取得 API Key 查看完整 API 文件
公開模型 ID
flux-3-image
輸出檔位
1K / 2K / 4K（預設 1K）
計費方式
按請求與所選解析度
生成接口
POST /v1/images/tasks
目錄快照

FLUX 3 Image 是什麼？

公開 ID flux-3-image 目前對應 Kie AI 的 FLUX 3 Klein 接入，不代表 BFL 完整版 FLUX 3 Image 的全部能力。

客戶端沿用同一模型 ID：未提供參考圖時產生新圖，提供 1–10 張公開圖片 URL 時自動編輯或組合參考內容。

解析度為 1K、2K、4K，每次可要求 1–4 張。採非同步任務提交與查詢，費用依解析度及實際成功輸出張數計算。

核心能力

文生圖

以提示詞描述主體、背景與風格，無須切換上游模型。

參考圖編輯

提供 1–10 張參考圖，說明要修改與保留的內容；結果仍須人工檢查。

批次輸出

n 可設為 1–4，依實際成功輸出張數結算。

三檔解析度

可選 1K、2K 或 4K，搭配目前支援的長寬比。

FLUX 3 Image API 價格

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

解析度價格計費單位
1k$0.01每張輸出
2k$0.016每張輸出
4k$0.036每張輸出

費用怎麼算？

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

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

1 張 4K 輸出1 × $0.0325 = $0.0325

依實際成功張數結算；此為目前價格快照的計算範例。

參數與支援範圍

以下參數來自目前的 Kie 接入設定。參考圖僅接受公開 HTTP / HTTPS URL；未開放專用邊界框版面、grounding 或 safety_tolerance 參數。

參數可用值說明
prompttextarea描述要產生的畫面，或說明要對參考圖做哪些修改。 · 必填
imagesurl · 1–10僅支援公開 HTTP / HTTPS 圖片 URL，最多 10 張；不接受 Base64 或瀏覽器 blob: 位址。 · 可選
aspect_ratioauto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21編輯時 auto 跟隨參考圖；文生圖省略或傳入 auto 時使用 1:1。 · 預設: auto · 可選
resolution1k / 2k / 4k選擇目前模型設定的輸出解析度檔位；此值可能直接影響價格。 · 預設: 1k · 可選
n1–4一次請求生成的圖片數量；數量越多費用越高。 · 預設: 1 · 可選
output_formatpng / jpeg / webp產生圖片的檔案格式，可選 png 或 jpeg。 · 預設: png · 可選
enhance_promptboolean可選
seedinteger可選

用 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": "A ceramic mug on a white studio background, soft side lighting.",
  "aspect_ratio": "16:9",
  "resolution": "2k"
}'

查詢恢復任務

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 的重放會回傳原任務而不重複計費。

適合哪些場景？

產品場景草圖

描述產品、燈光與背景，先以 1K 檢查構圖。

A ceramic mug on a white studio background, soft side lighting.

背景與顏色修改

提供參考圖，明確說明修改與保留內容；勿假定其餘區域像素完全不變。

Change the mug to blue while keeping its shape and the white background.

多參考圖組合

說明各張參考圖提供的主體、風格或場景資訊。

Use the product from image 1 and the background from image 2.

多版本探索

使用 n 要求最多 4 張結果，再由人工選擇合適版本。

Create alternative studio compositions of a ceramic mug.

使用前要知道的限制

  • 參考圖為 1–10 張公開 HTTP / HTTPS URL；不支援 Base64、Data URL 或 blob: 位址。
  • 支援 9 種固定長寬比；編輯可用 auto，文生圖省略或傳入 auto 時使用 1:1。
  • 目前接入 FLUX 3 Klein，不承諾局部編輯之外的像素完全保留，也未開放完整版特有的版面控制與連網檢索參數。
  • 提交成功僅表示受理；必須查詢至最終狀態，並檢查圖片是否符合用途。

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

依實際任務、參考圖限制、解析度及目前目錄價格選擇模型；本頁未進行同條件效果或速度比較。

全部模型 →

FLUX 3 Image 常見問題

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

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

FLUX 3 Image API 多少錢？

按生成圖片數量與所選解析度計費：1K $0.008、2K $0.0125、4K $0.0325。核驗時數值與 Kie AI 標準價相同，但 Roko 結算以提交時的專案估價與最終帳單為準。

文生圖與圖片編輯需要切換模型 ID 嗎？

不需要。沿用 flux-3-image，未提供參考圖時文生圖，提供圖片後自動選擇編輯模型。

如何傳入參考圖？

透過 image_urls 或 images 提供 1–10 張公開 HTTP / HTTPS 圖片 URL；也相容 image 與 input_reference。

支援哪些解析度與長寬比？

解析度為 1K、2K、4K；固定比例為 1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、9:21。編輯可用 auto，文生圖的 auto 使用 1:1。

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

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

這是 BFL 完整版 API 嗎？

目前透過 Kie AI 接入 FLUX 3 Klein，未開放專用邊界框版面與連網檢索參數，不能據此推斷完整版能力。

一次可以產生幾張圖片？

n 為 1–4，預設 1；依實際成功輸出張數與所選解析度結算。