图像生成
FLUX 系列
Black Forest Labs FLUX 图像模型:FLUX.2 按百万像素档出图,FLUX.1 Kontext 按张固定价做上下文编辑
POST
FLUX 系列
FLUX 是 Black Forest Labs 的图像模型系列,本页覆盖当前可用的五个模型,分成两代:FLUX.2 可以选输出的百万像素档、最多带 8 张参考图,按 MP 档计价;FLUX.1 Kontext 专做上下文编辑,输出固定 1 MP、最多 4 张参考图,按张固定价。两代共用同一个任务接口和同一套动作,换模型只改
提交成功后返回
通用的
model。FLUX 3 Image 的参数与分档不同,见 FLUX 3 Image。
快速开始
task_id。用 GET /v1/tasks/{task_id} 查询结果,也可以用 Prefer: wait 在一次调用里等待,或配置 Webhook。
请求参数
string
必填
五选一:
flux-2-pro、flux-2-max、flux-2-flex、flux-kontext-pro 或 flux-kontext-max。string
默认值:"generate"
generate:根据文字生成图片edit:基于参考图改写;必须提供image_urls
string
必填
图片描述或编辑指令。
string[]
参考图片 URL 数组。
edit 时必填,generate 不接受参考图。FLUX.2 最多 8 张,FLUX.1 Kontext 最多 4 张。string
默认值:"1:1"
画面比例:
1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、9:21、auto。auto 表示由模型决定比例。string
默认值:"2mp"
输出图的百万像素档:
1mp、2mp、3mp、4mp。只有 FLUX.2 三个模型接受这个参数;FLUX.1 Kontext 输出固定 1 MP。integer
默认值:"1"
生成数量,取值
1。每次请求返回一张图。integer
随机种子。同一组参数配同一个种子,结果保持一致。
string
输出图片格式:
jpeg、png 或 webp。FLUX.2 默认 jpeg,FLUX.1 Kontext 默认 png。boolean
默认值:"false"
是否由上游先扩写提示词再生成。
integer
默认值:"2"
内容安全容忍级别,数值越大越宽松。FLUX.2 取
0–5,FLUX.1 Kontext 取 0–6。integer
默认值:"50"
推理步数,取
1–50。步数越多细节越足、耗时越长。只有 flux-2-flex 支持。number
默认值:"5"
提示词引导强度,取
1.5–10。数值越大越贴合提示词。只有 flux-2-flex 支持。callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。
本系列不接受 quality、negative_prompt、watermark 和 mask_url。以上之外的参数会返回 400,不计费。
限制
计费
按成功出图的固定张价结算,两代的计费维度不同。 单价见GET /v1/models 返回的 price_config,或控制台「模型市场」。单次调用的实际花费见任务响应里的 cost——整数 quota,500,000 quota = 1 USD,不是美元。
FLUX.2(flux-2-pro / flux-2-max / flux-2-flex)
- 输出图按
resolution的百万像素档收费,1mp、2mp、3mp、4mp各一档,档越高越贵;不传或传了档位之外的值时按兜底价结算,兜底价等于2mp档 - 参考图每张另计,加在输出图的价格上:只带 1 张时,按该图实际像素向上取整到的 MP 档收;带 2 张及以上时,每张按最低档收
- 三个模型各有一组 MP 档价,
flux-2-flex的steps与guidance不影响价格
flux-kontext-pro / flux-kontext-max)
- 单一固定张价,输出固定 1 MP,参考图不加价,画幅与
output_format都不影响价格
响应
任务完成
result.images 返回生成的图片,expires_at 是该链接的失效时间戳。完整字段说明见查询任务状态。
可用模型
五个模型都支持
generate 与 edit,每次请求出 1 张图,都接受 seed,画幅集合相同:1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、9:21、auto。
- FLUX.2 用
resolution选百万像素档:1mp到4mp,默认2mp;档越高越贵 - FLUX.1 Kontext 不接受
resolution,输出固定 1 MP safety_tolerance的范围两代不同:FLUX.2 是0–5,Kontext 是0–6,数值越大越宽松output_format默认值两代不同:FLUX.2 默认jpeg,Kontext 默认png