> ## 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 Banana2 图像生成

> Nano Banana2 图像生成 API：基于 Gemini 3.1 Flash。仅 0.055 美元/张，支持文生图+图改图，4K分辨率，兼容 OpenAI SDK 和 Google 原生格式。

<Note>
  **🆕 Nano Banana2 (Gemini 3.1 Flash) 全新上线！**
  轻量图像生成方案，用法与 Nano Banana Pro 完全相同。

  * **按量接入**: 仅 **\$0.055/张**，比 Pro 版更成本较低
  * **4K 画质**: 支持 1K, 2K, 4K 三种分辨率
  * **全功能**: 文生图 + 图改图，兼容 OpenAI SDK 和 Google 原生格式
</Note>

<CardGroup cols={2}>
  <Card title="控制台入口" icon="key" href="https://api.laozhang.ai">
    创建 API Key，查看余额和调用日志
  </Card>

  <Card title="🚀 在线测试" icon="play" href="https://yingtu.ai">
    影图 AI 即刻体验，无需写代码
  </Card>
</CardGroup>

## 前置要求

<Steps>
  <Step title="获取 API Key">
    登录 [laozhang.ai 控制台](https://api.laozhang.ai) 获取 API 密钥
  </Step>

  <Step title="配置计费模式">
    编辑令牌设置，选择以下任一计费模式（两者价格相同）：

    * **按量优先**（推荐）：优先使用余额计费，余额不足时自动切换
    * **按次计费**：每次调用直接扣费，适合预算控制严格的场景

    <Note>
      两种模式**价格完全相同**，都是 \$0.055/张，仅扣费方式不同。
    </Note>

    <Warning>
      **按次扣费说明**：Nano Banana2 以 Google 官方返回的成功调用为计费依据。若 Prompt 没有明确要求“生成图片/返回图片数据”，或文本、参考图触发 Google 官方版权 IP、敏感人物、敏感内容风控，可能出现“调用成功但没有图片返回”的情况，此时通常仍按一次成功调用扣费。429、5xx、网络超时、参数校验失败等官方异常请以控制台订单状态为准。
    </Warning>

    <img src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/sora2-token-setting.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=d54128f51509467d6b73d207bbe5c86f" alt="令牌设置" width="1280" height="537" data-path="images/sora2-token-setting.png" />

    <Warning>
      如果未设置计费模式，API调用会失败。必须先完成此配置！
    </Warning>
  </Step>
</Steps>

## 模型简介

**Nano Banana2** 是老张API对 Google **Gemini 3.1 Flash Image Preview** (`gemini-3.1-flash-image-preview`) 模型的定制版称呼。它基于最新的 Gemini 3.1 Flash 架构，在保持高质量输出的同时提供更可控的调用成本。

**Nano Banana2 的用法与 [Nano Banana Pro](/api-capabilities/nano-banana-pro-image) 完全相同**，价格将模型名替换为 `gemini-3.1-flash-image-preview` 即可。

## 📋 三款 Nano Banana 模型对比

| 模型                  | 模型 ID                            | 计费方式 | 老张API价格   | 分辨率      | 速度    | 特色         |
| ------------------- | -------------------------------- | ---- | --------- | -------- | ----- | ---------- |
| **Nano Banana Pro** | `gemini-3-pro-image-preview`     | 按次计费 | \$0.09/张  | 1K/2K/4K | \~10秒 | 最强智能，复杂指令  |
| **Nano Banana2**    | `gemini-3.1-flash-image-preview` | 按次计费 | \$0.055/张 | 1K/2K/4K | \~10秒 | 日常高级用途，高质量 |
| **Nano Banana**     | `gemini-2.5-flash-image`         | 按次计费 | \$0.025/张 | 1K（固定）   | \~10秒 | 基础版，稳定可靠   |

<Tip>
  💡 **如何选择？**

  * **追求极致质量和复杂指令**: 选 Nano Banana Pro（\$0.09/张）
  * **日常高级用途，日常高级用途**: 选 **Nano Banana2**（\$0.055/张）
  * **预算敏感，基础需求**: 选 Nano Banana Standard（\$0.025/张）
</Tip>

## 🚀 快速开始：OpenAI 兼容模式

### Curl 示例

```bash theme={null}
curl -X POST "https://api.laozhang.ai/v1/chat/completions" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
    "model": "gemini-3.1-flash-image-preview",
    "stream": false,
    "messages": [
        {
            "role": "user",
            "content": "a beautiful sunset over mountains"
        }
    ]
}'
```

### Python SDK 示例

```python theme={null}
from openai import OpenAI
import base64
import re

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api.laozhang.ai/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {
            "role": "user",
            "content": "a beautiful sunset over mountains"
        }
    ]
)

# 提取 base64 图片数据
content = response.choices[0].message.content
match = re.search(r'!\[.*?\]\((data:image/png;base64,.*?)\)', content)

if match:
    base64_data = match.group(1).split(',')[1]
    image_data = base64.b64decode(base64_data)

    with open('output.png', 'wb') as f:
        f.write(image_data)
    print("✅ 图片已保存: output.png")
```

## 🎨 图改图

Nano Banana2 同样支持图改图功能，用法与 Pro 完全一致。价格在请求中传入参考图片和编辑指令，并将模型名设为 `gemini-3.1-flash-image-preview`。

```python theme={null}
# 图改图示例（OpenAI 兼容模式）
response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "把这张图变成梵高星空风格的油画"},
            {"type": "image_url", "image_url": {"url": "https://example.com/your-image.jpg"}}
        ]
    }]
)
```

<Info>
  更多图改图用法（多图融合、4K 输出、Google 原生格式等），请参考 [Nano Banana Pro 图改图文档](/api-capabilities/nano-banana-pro-image-edit)，将模型名替换为 `gemini-3.1-flash-image-preview` 即可。
</Info>

## 📖 完整用法指南

<Info>
  **Nano Banana2 的调用方式与 Nano Banana Pro 完全相同**，包括 OpenAI 兼容模式和 Google 原生格式。价格将模型名从 `gemini-3-pro-image-preview` 替换为 `gemini-3.1-flash-image-preview`，其他代码无需修改。
</Info>

<CardGroup cols={2}>
  <Card title="Pro 文生图完整指南" icon="image" href="/api-capabilities/nano-banana-pro-image">
    4K 分辨率、Google 原生格式、多种纵横比、完整代码示例
  </Card>

  <Card title="Pro 图改图完整指南" icon="paintbrush" href="/api-capabilities/nano-banana-pro-image-edit">
    风格转换、多图融合、4K 高清编辑、URL 输入方式
  </Card>

  <Card title="令牌管理" icon="key" href="https://api.laozhang.ai/token">
    创建和管理你的 API 令牌
  </Card>

  <Card title="价格说明" icon="dollar-sign" href="/pricing">
    查看详细的价格表和计费说明
  </Card>
</CardGroup>

## ❓ 常见问题

<AccordionGroup>
  <Accordion title="Nano Banana2 和 Nano Banana Pro 有什么区别？">
    | 特性   | Nano Banana Pro              | Nano Banana2                     |
    | ---- | ---------------------------- | -------------------------------- |
    | 模型   | `gemini-3-pro-image-preview` | `gemini-3.1-flash-image-preview` |
    | 技术   | Gemini 3 Pro                 | Gemini 3.1 Flash                 |
    | 分辨率  | 1K/2K/4K                     | 1K/2K/4K                         |
    | 价格   | \$0.09/张                     | \$0.055/张                        |
    | 调用方式 | 完全相同                         | 完全相同                             |

    两者用法完全一致，Banana2 基于 Gemini 3.1 Flash 架构，价格更便于成本核算。
  </Accordion>

  <Accordion title="如何从 Pro 迁移到 Banana2？">
    价格修改一行代码：将模型名从 `gemini-3-pro-image-preview` 改为 `gemini-3.1-flash-image-preview`，其他完全不变。
  </Accordion>

  <Accordion title="Banana2 支持 Google 原生格式吗？">
    **完全支持！** 使用以下端点：

    ```
    https://api.laozhang.ai/v1beta/models/gemini-3.1-flash-image-preview:generateContent
    ```

    支持自定义纵横比（10 种）和分辨率（1K/2K/4K），用法与 Pro 相同。
  </Accordion>

  <Accordion title="Banana2 支持图改图吗？">
    **支持！** 文生图和图改图功能完整，参考 [Pro 图改图文档](/api-capabilities/nano-banana-pro-image-edit) 即可。
  </Accordion>
</AccordionGroup>

***

## 📝 更新日志

<AccordionGroup>
  <Accordion title="2026-02：Nano Banana2 上线">
    **🆕 Nano Banana2 全新发布**

    * 基于 Gemini 3.1 Flash 架构
    * 价格已同步为当前页面标价，成本表现以控制台价格为准
    * 用法与 Nano Banana Pro 完全一致
    * 支持文生图、图改图、4K 分辨率
  </Accordion>
</AccordionGroup>