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

**方法**: `POST`
**路径**: `/fal-ai/flux-pro/kontext/multi`

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

## 请求参数

### Header 参数

```text
Content-Type
string
可选
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
prompt
string
必需
描述你想对图片实现的编辑目标。必填。
image_urls
array
[string]
必需
要编辑的图片URL列表。必填。
aspect_ratio
enum<string>
可选
可选。输出图片宽高比。如'16:9'
枚举值:
21:9
16:9
4:3
3:2
1:1
2:3
3:4
9:16
9:21
guidance_scale
number
可选
引导强度，数值越大越偏向prompt描述，默认3.5
sync_mode
boolean
可选
是否同步返回结果，true同步返回图片，false异步(推荐)
num_images
integer
可选
返回图片数量，1-4
output_format
enum<string>
可选
图片返回格式，可选jpeg/png
枚举值:
jpeg
png
safety_tolerance
enum<string>
可选
风险内容检测敏感级别。1最严，6最宽松
枚举值:
1
2
3
4
5
6
seed
integer
可选
生成图片的随机种子(可选，相同seed可复刻同样生成结果)
示例
{
"prompt"
:
"string"
,
"image_urls"
:
[
"string"
]
,
"aspect_ratio"
:
"21:9"
,
"guidance_scale"
:
0
,
"sync_mode"
:
true
,
"num_images"
:
0
,
"output_format"
:
"jpeg"
,
"safety_tolerance"
:
"1"
,
"seed"
:
0
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/fal-ai/flux-pro/kontext/multi' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "image_urls": [
        "string"
    ],
    "aspect_ratio": "21:9",
    "guidance_scale": 0,
    "sync_mode": true,
    "num_images": 0,
    "output_format": "jpeg",
    "safety_tolerance": "1",
    "seed": 0
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
status
string
必需
request_id
string
必需
response_url
string
必需
status_url
string
必需
cancel_url
string
必需
queue_position
integer
必需
```

#### 示例

```json
{
    "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
}
```