Gemini Nano Banana 图片生成

Nano Banana 图片生成

Google Gemini 原生 :generateContent 路径，同步返回，无需轮询。图片在 candidates[0].content.parts[].inlineData 字段中。

接入地址

线路	Base URL	说明
国内加速（推荐）	`https://cdn.wusag.com`	走国内 CDN 节点
海外直连	`https://api.xinliu.one`	海外服务器或加速节点异常时使用

两个地址共用同一账户和 Key。

请求

方法：POST {Base URL}/v1beta/models/{model}:generateContent

Header：

Authorization: Bearer 你的令牌

Content-Type: application/json

可用模型（路径中替换 `{model}`）

model	备注
`gemini-2.5-flash-image-preview`	Nano Banana
`gemini-3.1-flash-image-preview`	Nano Banana 2
`gemini-3-pro-image-preview`	Nano Banana Pro

参数

字段	类型	必填	说明
`contents`	array	是	对话内容列表
`contents[].role`	string	是	固定 `"user"`
`contents[].parts`	array	是	内容部件
`contents[].parts[].text`	string	文生图必填	提示词，最长 10000 字符
`contents[].parts[].inline_data`	object	图生图必填	参考图对象
`contents[].parts[].inline_data.mime_type`	string	图生图必填	如 `image/png` `image/jpeg`
`contents[].parts[].inline_data.data`	string	图生图必填	Base64（不含 `data:` 前缀）
`generationConfig`	object	否	生成配置，控制输出比例
`generationConfig.responseModalities`	array	否	固定 `["IMAGE"]`
`generationConfig.imageConfig.aspectRatio`	string	否	输出比例，5 档：`1:1` / `16:9` / `9:16` / `4:3` / `3:4`，默认 `1:1`

输出比例

通过 generationConfig.imageConfig.aspectRatio 控制：

aspectRatio	方向
`1:1`	正方形（默认）
`16:9`	横版
`9:16`	竖版
`4:3`	横版
`3:4`	竖版

不传该字段输出 1:1。

文生图请求体

{
  "contents": [{
    "role": "user",
    "parts": [{ "text": "一片日出，远山如黛" }]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": { "aspectRatio": "16:9" }
  }
}

图生图请求体

{
  "contents": [{
    "role": "user",
    "parts": [
      {
        "inline_data": {
          "mime_type": "image/png",
          "data": "iVBORw0KGgoAAAA..."
        }
      },
      { "text": "改成赛博朋克风格" }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": { "aspectRatio": "9:16" }
  }
}

返回字段

图片在 candidates[0].content.parts[0].inlineData.data，base64 解码后保存即可。

同路径其他用途

本路径除了图片生成，也可用于纯文本对话和多模态识别（输入图片/PDF/音频/视频提问），切换 {model} 为 gemini-2.5-flash 等聊天模型即可。详见「通用接口 → 文本通用接口（Gemini 原生格式）」。

请求示例（文生图）

请求示例（图生图）

返回示例

图片通过 candidates[0].content.parts[].inlineData.data 返回 base64，按 mimeType 解码保存。

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [{"inlineData": {"mimeType": "image/png", "data": "..."}}]
    },
    "finishReason": "STOP"
  }],
  "modelVersion": "gemini-3-pro-image-preview"
}

错误码

400 参数错误

401 令牌无效或未提供

402 余额不足

404 模型不存在或未开通

429 速率限制

500 服务端错误

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

Body 参数application/json

示例

{
    "contents": [
        {
            "role": "string",
            "parts": [
                "string"
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": [
            "string"
        ],
        "imageConfig": {
            "aspectRatio": "1:1"
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Nano Banana 图片生成#

接入地址#

请求#

可用模型（路径中替换 {model}）#

参数#

输出比例#

文生图请求体#

图生图请求体#

返回字段#

同路径其他用途#

请求示例（文生图）#

请求示例（图生图）#

返回示例#

错误码#