众扬汇 AI 开放平台 API 文档

Nano-banana(Edits兼容)

OpenAPI Specification

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

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

请求头

  • Authorization:可选,string,默认 Bearer {{YOUR_API_KEY}}。

请求体(multipart/form-data)

  • model:必填,string,示例 nano-banana。

  • prompt:必填,string,示例 一只猫。

  • image:必填,string(binary),参考图;支持多张,也支持不带参考图。多图时重复该字段上传本地图片文件即可。

  • response_format:可选,string,取值 url 或 b64_json,示例 url。

  • aspect_ratio:可选,string,图片比例,取值 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。

  • size:可选,string,出图尺寸。

响应

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

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 补充说明:原文对模型取值的说明——nano-banana 面向画图场景做了优化,支持本接口的图片格式与链接返回,并可设置图片比例;nano-banana-hd 为 4K 高清版;调用失败不扣费。相较之下,gemini-2.5-flash-image-preview 为上游原生模型,仅支持聊天接口,可能不返回图片,且返回的图片为 base64。