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

POST

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

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

责任人：未设置

实验性多图像编辑API，支持对多张图片，结合文本提示进行图像内容上下文理解和修改。广泛用于AI图片编辑、修图等场景。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

示例值:

Bearer {{API_KEY}}

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

prompt

string

必需

描述你想对图片实现的编辑目标。必填。

image_urls

array[string]

必需

要编辑的图片URL列表。必填。

aspect_ratio

enum<string>

可选

可选。输出图片宽高比。如'16:9'

枚举值:

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

guidance_scale

number

可选

引导强度，数值越大越偏向prompt描述，默认3.5

sync_mode

boolean

可选

是否同步返回结果，true同步返回图片，false异步(推荐)

num_images

integer

可选

返回图片数量，1-4

output_format

enum<string>

可选

图片返回格式，可选jpeg/png

枚举值:

jpegpng

safety_tolerance

enum<string>

可选

风险内容检测敏感级别。1最严，6最宽松

枚举值:

123456

seed

integer

可选

生成图片的随机种子(可选，相同seed可复刻同样生成结果)

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢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:04

FLUX.1 Kontext [Pro] 文本转图片

FLUX.1 Kontext [Max]