Skip to main content
POST
文生图:根据文本描述生成图片
右側的互動式 Playground 支援直接線上除錯。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),輸入 prompt、選擇模型與尺寸後一鍵傳送即可。
場景說明:本頁用於「文本生成圖片」,僅需輸入提示詞,無需上傳任何圖片。如需根據現有圖片做編輯、多圖融合,請使用 圖片編輯介面
⚠️ 關鍵差異 / 不支援的引數
  • 結果 URL 僅 10 分鐘有效data[0].url 必須立即下載,過期返回 404
  • width / height 必須是 16 的倍數 — 不滿足會 400 報錯
  • prompt_upsampling FLUX.2 [klein] 不支援 — 傳入會被忽略
  • 總畫素上限 4MP(約 2048×2048)— 超過會 400 報錯
  • grounding searchflux-2-max — 其它模型 prompt 含即時知識也不會觸發
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout,詳見 圖片 API 呼叫須知與最佳實踐

程式碼示例

Python(OpenAI SDK 直連)

Python(原生 requests · 含 width/height 寫法)

cURL

Node.js(原生 fetch)

瀏覽器 JavaScript(直接渲染)

引數說明速查

支援的模型 ID

詳細的引數約束、可選值、示例請檢視右側 Playground 中的欄位說明,所有 enum 欄位均支援下拉選擇。

響應格式

⚠️ data[0].url 僅 10 分鐘有效
  • URL 託管在 delivery-eu.bfl.ai / delivery-us.bfl.ai,簽名 10 分鐘過期
  • 不開啟 CORS,瀏覽器 fetch 會被攔,但 <img src> 直顯可行
  • 生產服務必須服務端代下載到自有 OSS / CDN,不要把原 URL 直接給客戶端
與 OpenAI gpt-image-2(返回 b64_json 純 base64)不同,FLUX 走 URL,不返回 base64
FLUX 不返回 usage 欄位(按張計費而非按 token),實際扣費按本文件定價表執行。響應頭 x-request-id 用於排查。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:flux-2-pro
必填

FLUX 模型 ID。FLUX.2 推荐 flux-2-pro / flux-2-max;旧版见历史版本页

可用選項:
flux-2-max,
flux-2-pro,
flux-2-flex,
flux-2-klein-9b,
flux-2-klein-4b,
flux-pro-1.1-ultra,
flux-pro-1.1,
flux-pro,
flux-dev
prompt
string
必填

提示词,最长 32K tokens。支持自然语言、hex 色码、结构化 JSON

範例:

"A cinematic shot of a futuristic city at sunset, 85mm lens"

size
string
預設值:1024x1024

OpenAI 风格尺寸字符串,与 width/height 二选一。 常用:1024x1024 / 1536x1024 / 1024x1536 / 1920x1080 / 1440x2048 / 2048x2048。 自定义需满足:边长 16 倍数、64×64–4MP 之间。

範例:

"1920x1080"

width
integer
預設值:1024

BFL 原生写法,与 size 二选一。必须是 16 的倍数,64–2048 之间

必填範圍: 64 <= x <= 2048
範例:

1920

height
integer
預設值:1024

BFL 原生写法,必须是 16 的倍数,64–2048 之间

必填範圍: 64 <= x <= 2048
範例:

1080

seed
integer

固定可复现,传相同 seed + 相同其它参数得一致结果

範例:

42

safety_tolerance
integer
預設值:2

审核档位。0 最严格,6 最宽松,默认 2

必填範圍: 0 <= x <= 6
output_format
enum<string>
預設值:jpeg

输出格式

可用選項:
jpeg,
png
prompt_upsampling
boolean
預設值:false

是否自动扩写 prompt。FLUX.2 [klein] 不支持,传入会被忽略

steps
integer
預設值:50

仅 flux-2-flex。推理步数,最大 50

必填範圍: 1 <= x <= 50
guidance
number
預設值:4.5

仅 flux-2-flex。引导强度。1.5–10,越高越贴 prompt

必填範圍: 1.5 <= x <= 10
n
enum<integer>
預設值:1

出图数量。本接口仅支持 1

可用選項:
1

回應

成功生成图片

created
integer

Unix 时间戳

範例:

1776832476

data
object[]

生成结果数组(本接口单次返回 1 张)