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

OpenAPI Specification

接口：POST /fal-ai/flux-pro/kontext/max/multi（完整地址 https://api.allyang.cn/fal-ai/flux-pro/kontext/max/multi）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

• Content-Type：可选，固定 application/json。
• Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

• prompt：必填，string，编辑指令，模型按该描述结合所给图片内容进行处理。
• image_urls：必填，array，元素为 string（uri），公网可访问的图片地址（如 https://example.com/...），至少 1 项，支持一次传多张做批量编辑。
• seed：可选，integer，随机种子，参数相同时结果保持一致。
• guidance_scale：可选，number，默认 3.5，提示词遵循程度，数值越大越贴合 prompt。
• sync_mode：可选，boolean，默认 false；为 true 时等待图片生成并上传完成后再返回，适合需要直接取得图片内容的场景。
• num_images：可选，integer，默认 1，取值 1 至 4，生成图片数量。
• safety_tolerance：可选，string，默认 2，取值 1 至 6；数值越大内容限制越宽松（1 最严格、6 最宽松）。
• output_format：可选，string，默认 jpeg，输出图片格式，取值 jpeg、png。
• aspect_ratio：可选，string，输出图片比例，取值 21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21。

原文对图片数组另设 minItems 约束（至少传 1 项）。

响应

• 200：成功，返回任务队列信息。
• status：string，任务状态。
• request_id：string，请求 ID。
• response_url：string，结果地址。
• status_url：string，状态查询地址。
• cancel_url：string，取消任务地址。
• queue_position：integer，排队位置。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 补充说明：原文将其归入上游平台兼容分组，并标注为实验性多图编辑能力；上述响应字段均为必填。