Skip to main content
POST

支持的模型

除标注为 Flex 专有的参数外,下列参数和像素限制均适用于以上三种模型。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证。获取 API Key:访问 API Key 管理页面 获取您的 API Key。使用时在请求头中添加:

Body

string
必填
模型名称:
  • flux-2-flex - 支持精细控制的 Flex 模型
  • flux-2-pro - 通用 Pro 模型
  • flux-2-max - 最高质量的 Max 模型
boolean
默认值:"false"
是否在提交图片任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
string
必填
图像生成或编辑的文本描述。
string
默认值:"2MP"
输出分辨率档位:
  • 1MP
  • 2MP(默认)
  • 3MP
  • 4MP
这里的 1MP 等于 1,048,576 像素。兼容旧别名:512 / 512P / 1M 等价于 1MP1K / 1024 等价于 2MP2K / 2048 等价于 3MP4K 等价于 4MP。其他值会导致任务失败。实际输出尺寸还取决于 size
string
默认值:"1:1"
输出图像的宽高比或像素尺寸。size 也支持 auto:传入 image_urls 时,会沿用参考图的宽高比,并保持当前 resolution 档位;未传参考图时按默认 1:1 处理。支持以下尺寸选项:
  • 1:1 - 方形(默认)
  • 4:3 - 横向
  • 3:4 - 纵向
  • 16:9 - 宽屏
  • 9:16 - 竖屏
  • 3:2 - 经典横向
  • 2:3 - 经典纵向
  • 21:9 - 超宽屏
  • 9:21 - 超竖屏
  • auto - 跟随参考图比例
也可以传入 "宽x高" 格式的像素串,例如 "1024x1536"。像素串优先于 resolution 和宽高比。
integer
精确输出宽度,单位为像素。必须与 height 成对传入,每项不得小于 64;只传其中一项会导致任务失败。widthheight 的优先级最高;同时传入时,会覆盖 resolutionsize
integer
精确输出高度,单位为像素。必须与 width 成对传入,每项不得小于 64;只传其中一项会导致任务失败。输出总像素不得超过 4MP,即 width × height ≤ 4,194,304
array
参考图像列表,用于图生图或多参考图融合。限制:
  • 最多支持 8 张图片
  • 支持公网可访问的 URL 或 Base64 输入
  • 输出图像与所有参考图的总像素不得超过 9MP
string
默认值:"jpeg"
输出图片的编码格式,支持 jpegpngwebp
integer
默认值:"1"
每次生成的图片张数。仅允许传入 1;需要多张图片时,请并发提交多个任务。
integer
随机种子。固定种子并保持其他参数一致时,可以复现相同结果;不传时随机生成。
boolean
默认值:"false"
是否启用提示词增强:
  • true - 启用
  • false - 禁用(默认)
显式传入 false 可关闭提示词改写。
integer
默认值:"2"
内容审核宽松度,取值范围为 0–5。数值越高,审核越宽松。
integer
默认值:"50"
采样步数,仅 flux-2-flex 支持。取值范围为 1–50;数值越高,通常细节越多、生成时间越长。
number
默认值:"5.0"
提示词引导强度,仅 flux-2-flex 支持。取值范围为 1.5–10;数值越高,生成结果通常越贴近提示词。

分辨率对照表

尺寸参数优先级为:成对的 width + heightsize 像素串 → resolution + size 宽高比 → 默认 2MP + 1:1

使用场景示例

基础文生图
最高质量生成
精确像素尺寸
多参考图融合
Flex 精细控制

Response

提交成功后,data 为数组,任务 ID 位于 data[0].task_id
integer
响应状态码。
array
返回数据数组。

查询任务结果

任务为异步处理。使用提交响应中的 task_id 请求以下接口,直到状态变为 completedfailed
任务状态包括: 完成响应示例:
result.images[].url 是字符串数组。本系列每次固定生成 1 张图片,请读取 url[0]。图片 URL 的有效期以同一对象中的 expires_at Unix 时间戳为准,请在到期前保存生成结果。

参数错误与失败响应

模型参数无效时,提交接口仍会返回 HTTP 200 和 task_id。请持续轮询,任务随后会进入 failed 状态,并在 data.error.message 中返回具体原因。失败任务会全额退款。
error.code 固定为 task_failed,具体失败原因请读取 error.message

注意事项

  1. 尺寸限制:输出图像不得超过 4MP,且宽、高均不得小于 64 像素。
  2. 总像素限制:输出图像与所有参考图的总像素不得超过 9MP。
  3. 参考图要求:最多支持 8 张参考图,可使用公网可访问的图片 URL 或 Base64 输入。
  4. 固定生成张数n 默认且只能为 1
  5. 提示词增强prompt_upsampling 默认为 false;显式传入 false 可关闭提示词改写。
  6. Flex 专有参数stepsguidance 仅适用于 flux-2-flex
  7. 异步任务:提交成功后,请轮询 /v1/tasks/{task_id} 获取最终结果。
  8. 结果链接:图片 URL 的有效期以响应中的 expires_at 为准。
  9. 异步参数错误:非法模型参数不会在提交时同步返回 4xx;必须轮询到 failed 并读取 data.error.message