Nano Banana 2 / Pro 文生图

Nano Banana 2 / Pro 提供基于 Gemini 原生 generateContent 协议的图片生成能力，适用于商品图、广告图、摄影风格图片、创意视觉内容等场景。

该接口使用 contents 结构传入提示词，并通过 generationConfig.imageConfig 控制图片比例与清晰度。

---

接口信息

HTTP 方法	POST
接口路径	/v1beta/models/{model}:generateContent
完整地址	https://api000.com/v1beta/models/{model}:generateContent
认证方式	Bearer Token
请求格式	application/json

---

可用模型

模型名称	说明
Nano Banana 2	Nano Banana 标准图片生成模型
Nano Banana Pro	Nano Banana Pro 高阶图片生成模型

请求地址中的 {model} 需要替换为实际模型名称。

示例：

https://api000.com/v1beta/models/Nano Banana 2:generateContent

https://api000.com/v1beta/models/Nano Banana Pro:generateContent

如客户端不支持路径中的空格，可使用 URL 编码形式：

Nano%20Banana%202
Nano%20Banana%20Pro

---

请求头

Header 参数	必填	示例
Authorization	是	Bearer sk-xxxxxxxxxxxxxxxx
Content-Type	是	application/json

---

请求体示例：2K 图片生成

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A premium skincare product on a clean white studio background, commercial photography, soft lighting, high detail, realistic style."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "2K"
    }
  }
}

---

请求体示例：4K 横版图片生成

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A luxury perfume bottle on a black reflective surface, cinematic commercial photography, premium lighting, ultra detailed, high-end advertising style."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "4K"
    }
  }
}

---

请求参数

参数	类型	必填	说明
contents	array	是	输入内容数组
contents[].role	string	是	用户消息角色，通常为 user
contents[].parts	array	是	消息内容分段
contents[].parts[].text	string	是	图片生成提示词
generationConfig	object	是	生成配置
generationConfig.responseModalities	array	是	输出模态，图片生成需包含 IMAGE
generationConfig.imageConfig.aspectRatio	string	否	图片比例
generationConfig.imageConfig.imageSize	string	否	图片清晰度，可使用 1K、2K、4K

---

常用图片比例

参数值	说明
1:1	正方形
16:9	横版宽屏
9:16	竖版短视频比例
4:5	电商与社媒常用竖图
5:4	横向产品展示
3:4	竖版摄影图
4:3	标准横图
3:2	摄影常用比例
2:3	竖版摄影比例
21:9	超宽横幅

实际可用比例以当前模型和渠道支持范围为准。

---

响应结果

接口成功后，图片通常以 Base64 形式返回，位置一般为：

candidates[].content.parts[].inlineData.data

客户端需要读取 inlineData.mimeType 判断图片格式，并将 inlineData.data 解码为图片文件。

---

注意事项

1. 本接口为 Gemini 原生协议，不是 OpenAI Images 协议。
2. 请求体中不使用 prompt、size、n、quality 等 OpenAI Images 字段。
3. 提示词应放在 contents[].parts[].text 中。
4. 图片比例和清晰度应通过 generationConfig.imageConfig 设置。
5. 返回图片通常为 Base64 数据，不是直接图片 URL。