ChatfireAPI

FLUX.1 Kontext [Max Multi]（实验性多图编辑）

POST

/fal-ai/flux-pro/kontext/max/multi

绘图模型/Flux 系列/Fal.ai 平台兼容

最后修改时间：2025-07-02 09:38:25

责任人：未设置

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

示例值:

Bearer {{API_KEY}}

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

prompt

string

必需

文本描述，模型将根据该描述及图片内容进行编辑

示例值:

Put the little duckling on top of the woman's t-shirt.

seed

integer

可选

随机种子，传入相同参数时图片结果保持一致

guidance_scale

number

可选

提示词遵循程度 (Classifier Free Guidance Scale)，数值越大越贴合prompt

默认值:

3.5

sync_mode

boolean

可选

同步模式。true时会等待图片生成并上传再返回，适合需要直接获得图片内容时

默认值:

false

num_images

integer

生成图片数量

可选

>= 1<= 4

默认值:

safety_tolerance

enum<string>

可选

安全容忍度，1最严格(内容少)，6最宽松(内容多)

枚举值:

123456

默认值:

output_format

enum<string>

输出图片格式

可选

枚举值:

jpegpng

默认值:

jpeg

aspect_ratio

enum<string>

输出图片比例

可选

枚举值:

21:916:94:33:21:12:33:49:169:21

image_urls

array[string <uri>]

必需

批量编辑的图片列表，支持多张图片

>= 1 items

示例

{
    "prompt": "Put the little duckling on top of the woman's t-shirt.",
    "guidance_scale": 3.5,
    "num_images": 1,
    "safety_tolerance": "2",
    "output_format": "jpeg",
    "image_urls": [
        "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
        "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/fal-ai/flux-pro/kontext/max/multi' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Put the little duckling on top of the woman'\''s t-shirt.",
    "guidance_scale": 3.5,
    "num_images": 1,
    "safety_tolerance": "2",
    "output_format": "jpeg",
    "image_urls": [
        "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
        "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
    ]
}'

返回响应

🟢200成功

application/json

Body

status

string

必需

request_id

string

必需

response_url

string

必需

status_url

string

必需

cancel_url

string

必需

queue_position

integer

必需

示例

{
    "status": "IN_QUEUE",
    "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
    "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
    "queue_position": 0
}

修改于 2025-07-02 09:38:25

FLUX.1 Kontext [Max]

FLUX.1 [Dev] 文本生成图片