众扬汇 AI 开放平台 API 文档

Nano-banana(Generations,推荐对接)

OpenAPI Specification

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

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

模型选择

  • gemini-2.5-flash-image-preview:官方原生模型标识,未作额外处理,仅支持聊天接口,且可能不返回图片;返回的图片为 base64。
  • nano-banana:面向绘图场景优化的模型标识,兼容 dalle 格式并返回 URL,失败不计费,另支持设置图片比例。
  • nano-banana-hd:高清 4K 画质版本。

请求体参数(application/json)

  • model:必填,string,模型标识,常见取值 nano-banana、nano-banana-hd。
  • prompt:必填,string,绘图提示词。
  • 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 之一。
  • image:可选,array,参考图数组,数组项为 string,取 URL 或 base64 数据。

响应

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

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