Flux异步图像生成

POST

/v1/async/images/generations

使用Black Forest Labs的Flux模型进行异步图像生成。支持多种Flux模型，包括文生图、图生图、图像编辑等功能。兼容官方API格式，额外添加model参数来选择不同的Flux模型。

支持的Flux模型：

图像生成模型：

flux-pro-1.1：Flux Pro 1.1 最新版本，高质量图像生成

flux-pro：Flux Pro 标准版本，专业级图像生成

flux-dev：Flux Dev 开发版本，适合开发和测试

flux-schnell：Flux Schnell 快速版本，生成速度快

专业功能模型：

flux-pro-1.1-ultra：Flux Pro 1.1 Ultra模式，超高质量图像生成，支持raw模式

flux-kontext-pro：Flux Kontext Pro，支持图像编辑和创建

flux-kontext-max：Flux Kontext Max，增强版图像编辑

flux-fill-pro：Flux Fill Pro，图像填充和修复，支持蒙版

flux-canny-pro：Flux Canny Pro，基于Canny边缘检测的图像生成

flux-depth-pro：Flux Depth Pro，基于深度图的图像生成

flux-realism：Flux Realism，专注于真实感图像生成

图像操作模型：

flux-outpaint：Flux Outpaint，图像扩展功能

flux-expand：Flux Expand，图像边缘扩展

通用参数说明：

大部分Flux模型支持以下通用参数：

prompt：文本提示词，描述希望生成的图像内容

width/height：图像尺寸（某些模型支持）

aspect_ratio：宽高比，如"1:1"、"16:9"、"9:16"等

seed：随机种子，用于复现结果

steps：生成步数，影响图像质量和生成时间

guidance：引导强度，控制提示词的影响程度

output_format：输出格式，支持"jpeg"、"png"、"webp"

safety_tolerance：安全容忍度，1-6级别

prompt_upsampling：是否增强提示词

特殊功能参数：

图像输入相关：

input_image：输入图像（Base64编码），用于图生图、图像编辑等

control_image：控制图像，用于Canny、Depth等控制模型

mask：蒙版图像，用于Fill等填充模型

回调相关：

webhook_url：完成后的回调URL

webhook_secret：回调验证密钥

模型特定参数：

不同模型可能有特定的参数要求和限制，具体请参考各模型的官方文档。

Request

Header Params

Content-Type

string

optional

请求体类型，固定为 application/json

Example:

application/json

Authorization

string

optional

API 鉴权 Token，格式为 Bearer {API_KEY}

Example:

Bearer

Body Params application/json

model

enum<string>

required

必选。Flux模型名称，支持多种Flux模型，包括文生图、图生图、图像编辑等。

Allowed values:

flux-pro-1.1flux-proflux-devflux-schnellflux-pro-1.1-ultraflux-kontext-proflux-kontext-maxflux-fill-proflux-canny-proflux-depth-proflux-realismflux-outpaintflux-expand

prompt

string

required

必选。文本提示词，描述希望生成的图像内容。

<= 10000 characters

width

integer

optional

可选。图像宽度，某些模型支持。范围：256-2048像素。

>= 256<= 2048

height

integer

optional

可选。图像高度，某些模型支持。范围：256-2048像素。

>= 256<= 2048

aspect_ratio

enum<string>

optional

可选。宽高比，如"1:1"、"16:9"、"9:16"等。优先级高于width/height。

Allowed values:

1:116:99:164:33:421:99:212:33:2

seed

integer

optional

可选。随机种子，用于复现结果。范围：0-2147483647。

>= 0<= 2147483647

steps

integer

optional

可选。生成步数，影响图像质量和生成时间。范围：1-50。

>= 1<= 50

guidance

number

optional

可选。引导强度，控制提示词的影响程度。范围：1.5-5.0。

>= 1.5<= 5

output_format

enum<string>

optional

可选。输出格式。

Allowed values:

jpegpngwebp

Default:

jpeg

safety_tolerance

integer

optional

可选。安全容忍度，级别1（最严格）到6（最宽松）。

>= 1<= 6

Default:

prompt_upsampling

boolean

optional

可选。是否增强提示词，系统会自动优化和扩展您的提示词。

Default:

true

input_image

string

optional

可选。输入图像（Base64编码），用于图生图、图像编辑等。格式：data:image/[jpeg|png|webp];base64,[data]

control_image

string

optional

可选。控制图像（Base64编码），用于Canny、Depth等控制模型。格式：data:image/[jpeg|png|webp];base64,[data]

mask

string

optional

可选。蒙版图像（Base64编码），用于Fill等填充模型。白色区域将被重新生成。格式：data:image/[jpeg|png|webp];base64,[data]

webhook_url

string <uri>

optional

可选。完成后的回调URL，任务完成时系统会向此URL发送POST请求。

webhook_secret

string

optional

可选。回调验证密钥，用于验证回调请求的真实性。

raw

boolean

optional

可选。是否使用raw模式，Ultra模型支持，生成更高质量但处理时间更长的图像。

Default:

false

Examples

Flux Pro基础图像生成示例Flux Kontext图像编辑示例Flux Fill图像填充示例Flux Canny控制生成示例Flux Ultra高质量生成示例

{
    "model": "flux-pro-1.1",
    "prompt": "A beautiful landscape with mountains and a lake at sunset",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
    "safety_tolerance": 2
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Flux Pro基础图像生成示例Flux Kontext图像编辑示例Flux Fill图像填充示例Flux Canny控制生成示例Flux Ultra高质量生成示例

curl --location --request POST '/v1/async/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "flux-pro-1.1",
    "prompt": "A beautiful landscape with mountains and a lake at sunset",
    "aspect_ratio": "16:9",
    "output_format": "jpeg",
    "safety_tolerance": 2
}'

Responses

🟢200OK

application/json

Flux图像生成任务提交成功

Body

string

optional

生成任务ID

polling_url

string

optional

轮询查询URL

Example

{
    "id": "string",
    "polling_url": "string"
}

🟠422Parameter Error

Modified at 2025-07-16 08:35:07

视频生成结果查询

可灵绘图

Flux异步图像生成

支持的Flux模型：#

图像生成模型：#

专业功能模型：#

图像操作模型：#

通用参数说明：#

特殊功能参数：#

图像输入相关：#

回调相关：#

模型特定参数：#

Request

Request samples

Responses

支持的Flux模型：

图像生成模型：

专业功能模型：

图像操作模型：

通用参数说明：

特殊功能参数：

图像输入相关：

回调相关：

模型特定参数：