Skip to main content
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.1 Kontext(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

相关文档