众扬汇 AI 开放平台 API 文档

FLUX.1 Kontext [Max]

OpenAPI Specification

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

鉴权:请求头 Authorization: Bearer {{YOUR_API_KEY}}(原文标注为可选)。

请求头

  • Content-Type:可选,固定 application/json。
  • Authorization:可选,string。

请求体参数(application/json)

  • prompt:必填,string,写清要对图像做哪种改动。
  • image_url:必填,string,指向待处理图像的地址,最好能被公网直接打开。
  • seed:可选,integer,固定取值即可复现同一张出图。
  • guidance_scale:可选,number,提示词贴合强度(CFG),可填 1 到 20,缺省 3.5。
  • sync_mode:可选,boolean,为真时当场阻塞取图,为假时改由 CDN 取回,缺省 false。
  • num_images:可选,integer,一次出几张,可填 1 到 4,缺省 1。
  • safety_tolerance:可选,string,审核松紧档位,档位数字由 1 到 6 依次放宽,缺省第 2 档。
  • output_format:可选,string,出图编码,填 jpeg 或 png,缺省 jpeg。
  • aspect_ratio:可选,string,出图画幅比例,备选值 21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21。

响应

  • 200:成功,返回对象;status、request_id、response_url、status_url、cancel_url 为 string,queue_position 为 integer,六项均为必填。

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