众扬汇 AI 开放平台 API 文档

Nano-banana-3.1-Flash(Edits兼容)

OpenAPI Specification

接口:POST /v1/images/edits(完整地址 https://api.allyang.cn/v1/images/edits)

鉴权:请求头 Authorization 传令牌,取值形如 Bearer {{YOUR_API_KEY}}(原文该字段非必填)。

请求体(multipart/form-data)

model、prompt、image 为必传字段。

  • model:必填,string,模型 ID,示例 gemini-3.1-flash-image-preview。
  • prompt:必填,string,编辑提示词,示例「一只猫」。
  • image:必填,binary,参考图片;可传多张,也可不带参考图。
  • response_format:可选,string,返回形式,取 url 或 b64_json,示例 url。
  • aspect_ratio:可选,string,画面比例,可选值:4:3、3:4、16:9、9:16、2:3、3:2、1:1、4:5、5:4、21:9、1:4、4:1、8:1、1:8。
  • image_size:可选,string,输出尺寸档位,取 1K、2K、4K、512 之一,示例 4K。

响应

  • 200:成功;原文未给出响应字段结构,待补。

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