Nano-banana-2(Pro) 官方格式 gemini-3-pro-image-preview

OpenAPI Specification

接口：POST /v1beta/models/gemini-3-pro-image-preview:generateContent（完整地址 https://api.allyang.cn/v1beta/models/gemini-3-pro-image-preview:generateContent）

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

请求头

• Content-Type：必填，固定 application/json。
• Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

• contents：必填，array，内容列表；每项为对象，含 parts（array）与 role（string）。

  • contents[].parts[]：object，内容片段；含 inlineData（必填）与 text。
  • contents[].parts[].inlineData：object，内联图片数据，含 data（string，图片数据）与 mimeType（string，媒体类型），两者均必填。
  • contents[].parts[].text：string，文本内容。

• generationConfig：可选，object，生成配置。

  • generationConfig.imageConfig：object，图片配置，含 aspectRatio（string，图片比例）与 imageSize（string，取值 1K、2K、4K）。
  • generationConfig.responseModalities：array，元素为 string，返回模态，示例 IMAGE。

响应

• 200：成功；原文未给出响应字段，待补。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 补充说明：请求示例中 contents[].parts 可同时包含多段 inlineData 与一段 text；generationConfig.imageConfig 示例取 aspectRatio 为 3:4、imageSize 为 2K。