FLUX 文生图 API 参考与在线调试 — FLUX.2 [klein/pro/max/flex] 全系列 OpenAI 兼容直连,支持 4MP 输出与 hex 精确色控
Bearer sk-xxx),输入 prompt、选择模型与尺寸后一键发送即可。| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | FLUX 模型 ID,见下表 |
prompt | string | 是 | — | 提示词,最长 32K tokens,支持中英文与结构化 JSON |
size | string | 否 | 1024x1024 | OpenAI 风格尺寸字符串,如 1920x1080 |
width | integer | 否 | 1024 | BFL 原生写法,与 size 二选一,必须 16 倍数 |
height | integer | 否 | 1024 | BFL 原生写法,必须 16 倍数 |
seed | integer | 否 | 随机 | 固定可复现 |
safety_tolerance | integer | 否 | 2 | 0(最严)– 6(最宽松) |
output_format | string | 否 | jpeg | jpeg / png |
prompt_upsampling | boolean | 否 | false | 自动扩写 prompt([klein] 不支持) |
steps | integer | 否 | 50 | 仅 flux-2-flex,最大 50 |
guidance | number | 否 | 4.5 | 仅 flux-2-flex,1.5–10 |
n | integer | 否 | 1 | 仅支持 1 |
| 模型 ID | 速度 | 适用 |
|---|---|---|
flux-2-max | < 15s | 旗舰画质 + 联网搜索 |
flux-2-pro | < 10s | 生产规模、最佳性价比 |
flux-2-flex | 较慢 | 文字渲染特化 |
flux-2-klein-9b | sub-second | 平衡型 |
flux-2-klein-4b | sub-second | 最快 |
flux-pro-1.1-ultra | ~10s | 老版 4MP(详见历史版本页) |
flux-pro-1.1 | ~5s | 老版 1.6MP |
flux-pro | ~6s | 初代 pro |
flux-dev | ~5s | 开发版 |
usage 字段(按张计费而非按 token),实际扣费按本文档定价表执行。响应头 x-request-id 用于排查。在 API易控制台获取的 API Key
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 提示词,最长 32K tokens。支持自然语言、hex 色码、结构化 JSON
"A cinematic shot of a futuristic city at sunset, 85mm lens"
OpenAI 风格尺寸字符串,与 width/height 二选一。
常用:1024x1024 / 1536x1024 / 1024x1536 / 1920x1080 / 1440x2048 / 2048x2048。
自定义需满足:边长 16 倍数、64×64–4MP 之间。
"1920x1080"
BFL 原生写法,与 size 二选一。必须是 16 的倍数,64–2048 之间
64 <= x <= 20481920
BFL 原生写法,必须是 16 的倍数,64–2048 之间
64 <= x <= 20481080
固定可复现,传相同 seed + 相同其它参数得一致结果
42
审核档位。0 最严格,6 最宽松,默认 2
0 <= x <= 6输出格式
jpeg, png 是否自动扩写 prompt。FLUX.2 [klein] 不支持,传入会被忽略
仅 flux-2-flex。推理步数,最大 50
1 <= x <= 50仅 flux-2-flex。引导强度。1.5–10,越高越贴 prompt
1.5 <= x <= 10出图数量。本接口仅支持 1
1