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

# Nano Banana 2.1 API 上线：价格、与 Nano Banana 2 的区别和接入

> 2026 年 10 月 7 日老张API上线 Google Nano Banana 2.1（gemini-nano-banana-2.1），每次 0.045 美元、1K–4K 同价：与 Nano Banana 2 的区别、切换方法和调用示例。

* **发布日期**：2026 年 10 月 7 日
* **最后核对**：2026 年 10 月 7 日
* **当前状态**：有效

老张API已上线 Google 的 Nano Banana 2.1（`gemini-nano-banana-2.1`），按次计费 \$0.045/次，1K、2K、4K 同价。它是 Nano Banana 2 的更新版，文字和信息图排版更准，单价比 Nano Banana 2 低 \$0.01，已有 Nano Banana 2 代码只需改模型 ID。

## 关键事实

| 项目 | 内容 |
| - | - |
| 模型 ID | `gemini-nano-banana-2.1` |
| 价格 | \$0.045/次，不随分辨率、思考级别、参考图数量变化 |
| 价格来源 | 2026 年 10 月 7 日公开价格配置，见[模型与价格总表](/models) |
| 令牌 | `default` 分组，计费模式为「按量优先」（推荐）或「按次计费」 |
| 接口 | Gemini 原生 `POST /v1beta/models/gemini-nano-banana-2.1:generateContent`，或 OpenAI 兼容 `POST /v1/chat/completions` |
| 分辨率 | `1K`（默认）、`2K`、`4K`；不支持 `512` |
| 比例 | 14 种，与 Nano Banana 2 相同 |
| 参考图 | 最多 14 张：物体 10 张、人物 4 张 |
| 思考级别 | `minimal`、`medium`（默认）、`high` |
| 搜索接地 | 网页搜索与图片搜索 |

## 和 Nano Banana 2 有什么不同

| 对比项 | Nano Banana 2.1 | Nano Banana 2 |
| - | - | - |
| 单价 | \$0.045/次 | \$0.055/次 |
| 分辨率 | 1K–4K | 0.5K–4K |
| 默认思考级别 | `medium` | `minimal` |
| 比例、参考图、搜索接地 | 相同 | 相同 |

按 [Google 模型说明](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1)，Nano Banana 2.1 的改进集中在三处：

* 图中文字渲染和信息图排版更准确；
* 多轮编辑中最多 4 个人物、10 个物体保持一致；
* 修复了 `1:4`、`4:1`、`1:8`、`8:1` 等宽幅、全景比例的拼接瑕疵。

## 影响范围

* **新项目**：Nano Banana 2.1 是 Nano Banana 系列的首选，1K–4K 都是 \$0.045/次。
* **已接入 Nano Banana 2**：不受影响，`gemini-3.1-flash-image` 继续可用、价格不变。想降低单价或改善文字效果时可以切换。
* **需要 0.5K**：继续使用 Nano Banana 2，Nano Banana 2.1 不支持 `512`。
* **只需要 1K 小图**：Nano Banana 2 Lite（\$0.025/次）仍是系列中单价最低的选择。

## 你需要做什么

<Steps>
  <Step title="确认令牌">
    使用 `default` 分组、计费模式为「按量优先」（推荐）或「按次计费」的令牌。已能调用 Nano Banana 2 的令牌可以直接调用 Nano Banana 2.1。
  </Step>

  <Step title="改模型 ID">
    Gemini 原生格式把 URL 中的模型换成 `gemini-nano-banana-2.1`；OpenAI 兼容格式改请求体的 `model`。请求结构和响应解析不变。
  </Step>

  <Step title="检查两个参数">
    * `imageSize` 为 `512` 的请求改成 `1K`，否则返回 400。
    * 没有设置思考级别时默认按 `medium` 思考。想要更快出图，传 `"thinkingConfig": {"thinkingLevel": "minimal"}`。
  </Step>
</Steps>

## 调用示例

生成一张 16:9 的 2K 图片，并用 `jq` 保存（需要 jq 1.6 及以上）：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl --fail-with-body --max-time 300 \
  "https://api.laozhang.ai/v1beta/models/gemini-nano-banana-2.1:generateContent" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "生成一张图片：雨后傍晚的城市街角咖啡馆，暖色灯光映在湿润的路面上，招牌写着 BANANA CAFE"}]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }' \
  -o nb21.json

jq -r '[.candidates[0].content.parts[] | select(.inlineData and (.thought | not))][-1].inlineData.data' nb21.json \
  | base64 --decode > nb21.jpg
```

* 返回的图片通常是 JPEG；按 `inlineData.mimeType` 判断格式更稳妥。
* 图片编辑、多参考图合成、搜索接地和 OpenAI 兼容格式的完整示例见 [Nano Banana 2.1 API](/api-capabilities/nano-banana-2-1-image)。

## 常见问题

### Nano Banana 2.1 比 Nano Banana 2 便宜多少？

每次便宜 \$0.01：Nano Banana 2.1 为 \$0.045/次，Nano Banana 2 为 \$0.055/次。两者都按次计费，输出 1K 还是 4K 价格相同。实际扣费以[调用日志](/faq/call-logs)为准。

### Nano Banana 2 会下线吗？

本次没有。`gemini-3.1-flash-image` 继续可用，价格不变。如有停止计划，会另发公告。

### 4K 也是 \$0.045 吗？

是。Nano Banana 系列在老张API只按次计费，分辨率和思考级别都不改变单价。Google 官方按 tokens 计费，4K 每张约 \$0.113，见 [Google 官方价格](https://ai.google.dev/gemini-api/docs/pricing)。

### 为什么传 `512` 返回 400？

Nano Banana 2.1 只支持 `1K`、`2K`、`4K`，参数错误的请求不扣费。需要 0.5K 时使用 Nano Banana 2。

### 用 OpenAI 兼容格式能调用吗？

可以，把 `model` 设为 `gemini-nano-banana-2.1`。这种格式不能指定比例和分辨率，输出 1K 图片，画幅由模型按内容决定；需要固定比例或 2K、4K 时用 Gemini 原生格式。

## 来源与相关文档

* [Nano Banana 2.1 API](/api-capabilities/nano-banana-2-1-image)：参数、生成与编辑示例、错误与计费
* [Nano Banana 总览](/api-capabilities/nano-banana-image)：五个模型对比、两种调用方式与计费规则
* [图像生成 API 选型与价格](/api-capabilities/image-generation-guide)：与 GPT Image、Seedream、FLUX.2 对比
* [模型与价格总表](/models)：当前价格与可用分组
* [控制台模型价格](https://api.laozhang.ai/account/pricing)：登录后查看令牌可用的模型与单价
* [Google Nano Banana 2.1 模型说明](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1)：官方能力与限制
* [Google Gemini API 价格](https://ai.google.dev/gemini-api/docs/pricing)：官方按 tokens 计费的价格


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.