众扬汇 AI 开放平台 API 文档

Nano-banana-3.1-Flash(Generations,推荐对接)

OpenAPI Specification

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

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

请求体参数(application/json)

必传字段为 model 与 prompt。

  • model:string,必传;示例值为 gemini-3.1-flash-image-preview。
  • prompt:string,必传;出图提示词,示例值为 cat。
  • response_format:string,可选;在 url 与 b64_json 之间二选一。
  • 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:array,可选;数组元素为 string,每个元素既可给 url 也可给 b64_json,作为参考图使用。
  • image_size:string,可选;可填 1K、2K、4K、512;原文档注明该字段只有 nano-banana-2 支持。

响应

  • 200:返回成功;原文档未描述响应体字段,待补。

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