众扬汇 AI 开放平台 API 文档

FLUX.1 Kontext [Multi](实验性多图编辑)

OpenAPI Specification

接口:POST /fal-ai/flux-pro/kontext/multi(完整地址 https://api.allyang.cn/fal-ai/flux-pro/kontext/multi)

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

请求头

  • Content-Type:可选,string,示例 application/json。

请求体参数(application/json)

必备字段只有 prompt 与 image_urls,其余均可省略。

  • prompt:必填,string,写清本次希望达成的编辑效果。
  • image_urls:必填,array,参与编辑的图片链接集合,元素为 string。
  • aspect_ratio:可选,string,成品画幅比例,备选 21:9 / 16:9 / 4:3 / 3:2 / 1:1 / 2:3 / 3:4 / 9:16 / 9:21。
  • guidance_scale:可选,number,提示词约束力度;值调大更遵从提示描述,缺省 3.5。
  • sync_mode:可选,boolean,结果回传方式;true 直接同步回图,false 走异步(建议用异步)。
  • num_images:可选,integer,单次产出图片条数,范围 1 至 4。
  • output_format:可选,string,输出编码格式,可在 jpeg 与 png 中选。
  • safety_tolerance:可选,string,内容风控档位,1 最严格,6 最宽松。
  • seed:可选,integer,随机数种子;沿用同一取值可得到一致的生成结果。

响应

  • 200:成功,返回任务对象。
  • status:string,当前任务所处状态。
  • request_id:string,本次调用标识。
  • response_url:string,成品获取地址。
  • status_url:string,进度查询地址。
  • cancel_url:string,撤回任务地址。
  • queue_position:integer,队列中的排位。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。