> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana 图片生成

Nano Banana 是 Google 推出的 Gemini 系列 AI 生图模型，支持通过文本、图片或两者结合的方式，以对话形式生成和编辑图片。

该系列包含三个主要模型，如下：

| 模型别名              | 官方模型名                            | 定位                   |
| ----------------- | -------------------------------- | -------------------- |
| `nano-banana`     | `gemini-2.5-flash-image`         | 速度优先，高吞吐低延迟          |
| `nano-banana-pro` | `gemini-3-pro-image-preview`     | 质量优先，支持 4K 高清与高级文本渲染 |
| `nano-banana-2`   | `gemini-3.1-flash-image-preview` | 针对速度和大规模使用场景进行了优化    |

<Callout type="info" icon="info-circle">
  Poixe 系统支持使用 **模型别名** 或 **官方原生模型名** 调用。
  别名仅为内部映射，如官方后续更新/替换模型，我们可能会同步调整别名映射以保持可用。
</Callout>

## 效果展示

Nano Banana 在文本渲染、复杂构图及东方美学理解上表现优异。

<Tabs>
  <Tab title="清明上河图">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-old-bridge.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=5b43db106667d0ddd3499d9aa1a7b4ab" alt="nano banana old bridge" width="1280" height="543" data-path="assets/images/nano-banana-old-bridge.png" />
  </Tab>

  <Tab title="电影分镜">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-movies.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=79b1c051e7204049905a7d5ee5d1733a" alt="nano banana movies" width="1536" height="2752" data-path="assets/images/nano-banana-movies.png" />
  </Tab>

  <Tab title="亚克力板">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-card.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=f21a96acd649e96181667c8bdf34ba89" alt="nano banana acrylic board" width="765" height="1024" data-path="assets/images/nano-banana-card.png" />
  </Tab>

  <Tab title="合照">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-pose.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=41f9ef77fc3a3106440f177319048164" alt="nano banana acrylic board" width="1080" height="1080" data-path="assets/images/nano-banana-pose.png" />
  </Tab>

  <Tab title="抖音截图">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-douyin.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=663ffbad7c01094fd0426197ff380d6e" alt="nano banana douyin" width="768" height="1376" data-path="assets/images/nano-banana-douyin.png" />
  </Tab>

  <Tab title="人物表情">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-emoticon.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=bc9e3c604eea389a34d02f20a0dcc1b5" alt="nano banana emoticon" width="1472" height="1133" data-path="assets/images/nano-banana-emoticon.png" />
  </Tab>

  <Tab title="时尚人物">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-fashion.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=d21124d4a9a8e552bc160427f9f385bb" alt="nano banana fashion" width="2286" height="4096" data-path="assets/images/nano-banana-fashion.png" />
  </Tab>

  <Tab title="妆面分析">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-makeup.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=43c3dd833db9369687fb1e162d7fdc7e" alt="nano banana makeup" width="1106" height="1943" data-path="assets/images/nano-banana-makeup.png" />
  </Tab>

  <Tab title="电影海报">
    <img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-poster.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=8caa490b83bd92cd1d18bcf4c638dd36" alt="nano banana poster" width="832" height="1248" data-path="assets/images/nano-banana-poster.png" />
  </Tab>
</Tabs>

## 模型对比

| 特性     | Nano Banana    | Nano Banana Pro | Nano Banana 2  |
| ------ | -------------- | --------------- | -------------- |
| 生成速度   | \~10秒          | \~20秒           | \~8秒           |
| 最大分辨率  | 1024×1024 (1K) | 4096×4096 (4K)  | 4096×4096 (4K) |
| 文本渲染   | 基础             | 优秀              | 良好             |
| 参考图片数量 | 最多 3 张         | 最多 14 张         | 最多 14 张        |
| 推理能力   | 标准             | 高级              | 标准+            |
| 局部编辑   | 基础             | 高级              | 进阶             |

**选择建议**：

* 需要快速出图、常规场景 → `nano-banana`
* 需要高清晰度、文字渲染、专业设计 → `nano-banana-pro`
* 需要更低成本+更高并发 → `nano-banana-2`

## 计费标准

Nano Banana 系列遵循 Google 官方的计费逻辑，同时享受 Poixe 平台的用户等级折扣。

模型基础计费分为三部分：提示词输入（Text/Image Input）、文本/思考输出（Text Output）、图像生成输出（Image Output）。

<Tabs>
  <Tab title="Nano Banana">
    对应 `nano-banana` 或 `gemini-2.5-flash-image`：

    * **输入 (文字/图片)**：\$0.30 / 1M Tokens
    * **输出 (文本)**：\$2.50 / 1M Tokens
    * **输出 (图片)**：\$30.00 / 1M Tokens
    * **折算单价**：每张标准图（1024x1024）消耗 1,290 tokens，约 **\$0.039/张**。
  </Tab>

  <Tab title="Nano Banana Pro">
    对应 `nano-banana-pro` 或 `gemini-3-pro-image-preview`：

    * **输入 (文字/图片)**：\$2.00 / 1M Tokens
    * **输出 (文本/思考)**：\$12.00 / 1M Tokens
    * **输出 (图片)**：\$120.00 / 1M Tokens
    * **折算单价**：
      * **1K/2K 分辨率**：消耗 1,120 tokens，约 **\$0.134/张**
      * **4K 分辨率**：消耗 2,000 tokens，约 **\$0.240/张**
  </Tab>

  <Tab title="Nano Banana 2">
    对应 `nano-banana-2` 或 `gemini-3.1-flash-image-preview`：

    * **输入**：\$0.5 / 1M Tokens
    * **输出文本**：\$3.00 / 1M Tokens
    * **输出图片**：\$60.00 / 1M Tokens
    * **折算单价**：
      * **0.5K 分辨率**：消耗 747 tokens，约 **\$0.045/张**
      * **1K 分辨率**：消耗 1,120 tokens，约 **\$0.067/张**
      * **2K 分辨率**：消耗 1,680 tokens，约 **\$0.101/张**
      * **4K 分辨率**：消耗 2,520 tokens，约 **\$0.151/张**
  </Tab>
</Tabs>

<Callout type="info" icon="info-circle">
  **注意**：以上仅为官方计费标准，Poixe 平台最终价格会在上述官方价格基础上，根据您的权益等级（Level）进行折扣计算。
</Callout>

## 快速开始

Poixe 通过 **Google Gemini Content 协议** 来提供 Nano Banana 系列模型，这也是官方推荐的调用方式。请参考以下文档了解详情：

<CardGroup cols={1}>
  <Card title="Google Gemini Content 协议" href="/cn/api-reference/text-api/google-gemini-content/overview">
    了解如何通过该协议调用 Nano Banana 系列模型
  </Card>
</CardGroup>

<Callout type="info" icon="info-circle">
  **注意**：Nano Banana 系列模型因为涉及图片生成，响应时间通常较长，我们推荐使用无 CDN 长连接更友好的副接口地址，相关配置请参考 [接口地址](/cn/api-reference/introduction/base-url)。

  如果您在调用过程中，连接意外中断，可以参考 [中断响应找回](/cn/api-reference/system-api/recoveries/overview) 文档，使用 Poixe 提供的恢复机制继续获取未完成的响应内容。
</Callout>

### 请求示例

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl "https://api.poixe.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: $POIXE_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "一只橘猫坐在窗台上看雨，赛博朋克风格"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["Text", "Image"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'
```

### 响应示例

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一只橘猫坐在窗台上看雨的赛博朋克风格图片。"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            },
            "thoughtSignature": "EtORtgIKzpG2Ag..."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 14,
    "candidatesTokenCount": 1253,
    "totalTokenCount": 1490,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 14
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": 1120
      }
    ],
    "thoughtsTokenCount": 223
  },
  "modelVersion": "gemini-3-pro-image-preview",
  "responseId": "cKaFae-1Ee307M8Py5OosAE"
}
```

### 输出预览

图片数据以 base64 编码返回，解码后即可获得 PNG/JPEG 格式图片。

<img src="https://mintcdn.com/terobox/6ZjcmaCT7UvKUscl/assets/images/nano-banana-pro-output.png?fit=max&auto=format&n=6ZjcmaCT7UvKUscl&q=85&s=064d59c3056521de1ecef366a3a82dbe" alt="nano banana pro output" width="2752" height="1536" data-path="assets/images/nano-banana-pro-output.png" />

<Callout type="info" icon="info-circle">
  可以使用在线工具（如 [Base64 Image Viewer](https://base64-image-viewer.poixe.com/)）或编程方式解码 base64 图片数据。
</Callout>

## 参数配置

### 输出类型

通过 `responseModalities` 控制返回内容：

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "generationConfig": {
    "responseModalities": ["Image"] // 仅返回图片，不含文本
  }
}
```

支持的格式：`Text`，`Image`

### 宽高比

通过 `imageConfig.aspectRatio` 设置画幅：

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "generationConfig": {
    "imageConfig": {
      "aspectRatio": "16:9" // 设置画幅为 16:9
    }
  }
}
```

支持的宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`

### 分辨率

支持的输出分辨率：

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "generationConfig": {
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "4K" // 设置分辨率为 4K
    }
  }
}
```

支持的宽高比： `1K`（1024x1024）、`2K`（2048x2048）、`4K`（4096x4096）

## Nano Banana Pro 独有功能

`nano-banana-pro` (`gemini-3-pro-image-preview`) 提供以下高级特性：

* **4K 高清输出**：支持 1K/2K/4K 三档分辨率
* **高级文本渲染**：适用于信息图表、菜单、营销素材等场景
* **思考模式**：模型会先生成构思草图，再输出最终高质量图片
* **多参考图混合**：最多支持 14 张参考图片（含 6 张高保真对象图 + 5 张人物图）
* **Google 搜索接地**：可基于实时数据生成图像（天气、股票等）

## Nano Banana 2 独有功能

`nano-banana-2` (`gemini-3.1-flash-image-preview`) 以主流价格提供高质量图片生成与对话式编辑能力，具备更低延迟与更高吞吐。它是 `nano-banana-pro` 的高效版本，专为速度敏感与高并发场景优化。

**主要更新：**

* **新增分辨率选项**：支持 `0.5K / 1K / 2K / 4K`（默认 1K）
* **实时搜索增强**：可融合文本与图片搜索结果，为生成提供实时信息参考
* **思考模式可控**：支持开启或关闭思考阶段
* **新增宽高比**：支持 `1:4`、`4:1`、`1:8`、`8:1`
* **宽高比遵循度提升**：生成画幅更稳定
* **图像质量与一致性提升**
* **多语言文本渲染优化（i18n）**

## 使用限制

* 最佳支持语言：英语、中文、日语、韩语、法语、德语、西班牙语等主流语言
* 不支持音频或视频输入
* 所有生成图片包含 [SynthID 水印](https://ai.google.dev/responsible/docs/safeguards/synthid?hl=zh-cn)
* 文字渲染建议：先让模型生成文字内容，再要求生成包含该文字的图片

## 客户端使用

推荐使用 [Cherry Studio](/cn/use-cases/chat/cherry-studio) 进行调用。配置模型提供商时，选择 [Google Gemini 原生协议](/cn/api-reference/text-api/google-gemini-content/overview)。

## 提示词资源

<CardGroup cols={2}>
  <Card title="Awesome Nano Banana Images" href="https://github.com/PicoTrex/Awesome-Nano-Banana-images">
    社区精选提示词与生成案例
  </Card>

  <Card title="Nano Banana Hackathon Kit" href="https://github.com/google-gemini/nano-banana-hackathon-kit">
    Google 官方 Hackathon 工具包
  </Card>
</CardGroup>

## 常见问题

<AccordionGroup>
  <Accordion title="应该选择哪个版本？">
    * 快速出图、常规场景 → `nano-banana` 或 `gemini-2.5-flash-image`
    * 高清输出、文字渲染、专业设计 → `nano-banana-pro` 或 `gemini-3-pro-image-preview`
    * 高并发批量生成或成本敏感场景 → `nano-banana-2` 或 `gemini-3.1-flash-image-preview`
  </Accordion>

  <Accordion title="nano-banana 和 gemini-2.5-flash-image 有什么区别？">
    完全相同。`nano-banana` 是 Poixe 系统内的别名映射，实际调用的是
    `gemini-2.5-flash-image`。

    同理，`nano-banana-pro` 对应 `gemini-3-pro-image-preview`，也是完全相同的模型。

    为保证稳定性，建议直接使用官方模型名。
  </Accordion>

  <Accordion title="生成的图片是什么格式？">
    返回 base64 编码的图片数据，通常为 PNG 或 JPEG 格式，解码后即可使用。
  </Accordion>

  <Accordion title="是否支持图片编辑？">
    支持。可以上传图片并通过对话方式进行编辑，Nano Banana Pro 模型的局部编辑能力更强大。
  </Accordion>

  <Accordion title="为什么生成的图片数量与要求不一致？">
    模型不一定严格按照用户要求的数量生成图片，这是模型的已知限制。
  </Accordion>
</AccordionGroup>

## 相关链接

* [Google Gemini 图片生成文档](https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn)
* [Nano Banana 官方定价](https://ai.google.dev/gemini-api/docs/pricing?hl=zh-cn#gemini-2.5-flash-image)
* [Nano Banana Pro 官方定价](https://ai.google.dev/gemini-api/docs/pricing?hl=zh-cn#gemini-3-pro-image-preview)
* [Nano Banana 2 官方定价](https://ai.google.dev/gemini-api/docs/pricing?hl=zh-cn#gemini-3.1-flash-image-preview)
* [Google Gemini Content API 协议](/cn/api-reference/text-api/google-gemini-content/overview)