> ## 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 Lite API

> Nano Banana 2 Lite API 中文文档：稳定模型 gemini-3.1-flash-lite-image，老张API 0.025 美元/次，支持 1K 生成、编辑、14 种宽高比和双协议代码。

<Note>
  **Nano Banana 2 Lite：低成本、高频图像生成路线**

  * **稳定模型 ID**：`gemini-3.1-flash-lite-image`
  * **老张API价格**：当前 **\$0.025/次**，实际价格与扣费以控制台为准
  * **模型定位**：1K 文生图、图改图、批量草稿、实时交互和高并发工作流
  * **接入方式**：OpenAI 兼容 `/v1/chat/completions` 或 Gemini 原生 `generateContent`
</Note>

<CardGroup cols={2}>
  <Card title="创建 API Key" icon="key" href="https://api.laozhang.ai/token">
    创建按次令牌并查看每次调用记录
  </Card>

  <Card title="查看图像生成 API 选型指南" icon="banana" href="/api-capabilities/image-generation-guide">
    对比 Standard、Lite、Nano Banana 2 和 Pro
  </Card>
</CardGroup>

## 为什么 Lite 适合低成本高并发？

Nano Banana 2 Lite 是 Google Gemini 3.1 Flash Lite Image 的市场名称。[Google 官方图像生成文档](https://ai.google.dev/gemini-api/docs/image-generation)将其定位为图像系列中的效率模型，稳定模型 ID 为 `gemini-3.1-flash-lite-image`，面向低延迟、高调用量的交互式应用。

| 项目                      | Nano Banana 2 Lite            |
| ----------------------- | ----------------------------- |
| 模型 ID                   | `gemini-3.1-flash-lite-image` |
| 版本                      | 稳定版（GA），不是 preview            |
| 老张API价格                 | **\$0.025/次**                 |
| Google Standard 参考价     | \$0.0336/张（1K）                |
| 分辨率                     | 仅 1K（1024px）                  |
| 宽高比                     | 支持 14 种离散比例                   |
| 输入                      | 文本、图片                         |
| 输出                      | 图片、文本                         |
| 图像编辑                    | 支持                            |
| Batch API               | Google 模型支持；老张API当前页面路线为按次调用  |
| Google Search grounding | 不支持                           |

<Tip>
  需要 2K/4K、视频转图或 Google Image Search grounding 时，请改用 [Nano Banana 2 API](/api-capabilities/nano-banana2-image)。需要最复杂的专业成片和精细品牌控制时，请使用 [Nano Banana Pro API](/api-capabilities/nano-banana-pro-image)。
</Tip>

## 价格为什么更适合批量任务？

老张API当前对 Nano Banana 2 Lite 提供按次调用路线，页面价格为 \$0.025/次；[Google 2026-07 Standard 参考价](https://ai.google.dev/gemini-api/docs/pricing)为 \$0.0336/张（1K）。以 10,000 次调用做静态单价估算：

| 路线                   |            单价 | 10,000 次静态估算 |
| -------------------- | ------------: | -----------: |
| 老张API Lite           | **\$0.025/次** |    **\$250** |
| Google Standard Lite |    \$0.0336/张 |        \$336 |

<Info>
  这只是单价乘法，不包含失败重试、输入 token、汇率、活动、税费或业务侧存储成本。实际扣费以控制台调用日志为准，不应把“最便宜”理解为对所有时间、地区、供应商和合同的永久保证。
</Info>

## 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-lite-image",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "生成一张 1:1 的极简咖啡产品图，米白背景，柔和阴影"
      }
    ]
  }'
```

### Python SDK

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

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-lite-image",
    messages=[
        {
            "role": "user",
            "content": "生成一张适合移动端首页的清爽蓝色 SaaS 插画",
        }
    ],
)

print(response.choices[0].message.content)
```

## Gemini 原生调用

Gemini 原生协议使用以下路径：

```text theme={null}
POST https://api.laozhang.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent
```

```bash theme={null}
curl -X POST \
  "https://api.laozhang.ai/v1beta/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "生成一张 16:9 的现代物流仪表盘概念图，深色背景，青色高光"}]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "1K"
      }
    }
  }'
```

<Warning>
  Lite 只支持 1K。传入 2K 或 4K 不会把 Lite 变成高分辨率模型；需要高分辨率请直接选择 `gemini-3.1-flash-image` 或 `gemini-3-pro-image`。
</Warning>

## 图改图调用

在 OpenAI 兼容格式中，把编辑指令和参考图 URL 放在同一条消息里：

```python theme={null}
response = client.chat.completions.create(
    model="gemini-3.1-flash-lite-image",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "保持产品不变，把背景替换成浅灰色摄影棚"},
            {
                "type": "image_url",
                "image_url": {"url": "https://example.com/product.jpg"},
            },
        ],
    }],
)
```

## 高并发接入建议

Lite 的模型定位适合高频交互，但生产吞吐仍需要工程控制：

1. 复用 HTTP 连接，不要为每张图重新创建客户端。
2. 对 429、5xx 和网络超时使用带抖动的指数退避。
3. 为请求设置业务超时和幂等标识，避免不确定重试造成重复扣费。
4. 记录请求 ID、模型、状态码、延迟和控制台订单状态。
5. 持续高并发上线前，向支持提供峰值并发、日调用量、提示词长度和输入图片大小做容量确认。

<Warning>
  老张API网关侧不设置固定的低并发套餐档位，不代表 Google 上游没有 RPM/IPM、项目配额、实时容量或安全策略。公开文档不承诺无条件“永久不限速”。
</Warning>

## 全球网络与 CDN 说明

应用统一请求 `https://api.laozhang.ai`，文档和静态资源通过 CDN 分发。CDN 可以改善 DNS、TLS 建连和静态内容传输，但图像生成耗时仍包含 API 网关处理、上游排队、模型推理和响应返回。请从你的真实部署地区做延迟和可用性测试。

## 常见问题

<AccordionGroup>
  <Accordion title="Nano Banana 2 Lite API 多少钱？">
    老张API当前为 \$0.025/次，价格以控制台为准。Google 2026-07 Standard 参考价为 \$0.0336/张（1K）。
  </Accordion>

  <Accordion title="Nano Banana 2 Lite 是稳定版吗？">
    是。当前稳定模型 ID 为 `gemini-3.1-flash-lite-image`，不是 preview 名称。
  </Accordion>

  <Accordion title="Lite 支持 2K 或 4K 吗？">
    不支持。Lite 只支持 1K。2K/4K 请用 `gemini-3.1-flash-image` 或 `gemini-3-pro-image`。
  </Accordion>

  <Accordion title="Lite 支持图片编辑吗？">
    支持文本加图片输入，可用于局部修改、背景调整、颜色替换、贴纸生成和快速迭代。
  </Accordion>

  <Accordion title="Lite 支持 Google Search grounding 吗？">
    不支持。需要 Web/Image Search grounding 时请选择 Nano Banana 2；需要专业级复杂生成可选择 Pro。
  </Accordion>

  <Accordion title="Lite API 可以高并发吗？">
    Lite 本身面向高调用量场景，老张API网关不设置固定低并发套餐档位；实际容量仍受上游和账号状态影响，大规模上线前应确认容量。
  </Accordion>

  <Accordion title="调用失败会扣费吗？">
    计费以控制台订单状态为准。429、5xx、网络超时和参数校验错误应结合日志判断；提示词触发安全策略或返回成功但无图片的情况要单独核对。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Nano Banana Standard API" icon="banana" href="/api-capabilities/nano-banana-image">
    查看现有 Nano Banana API 入口与跨模型对比
  </Card>

  <Card title="Nano Banana 2 API" icon="citrus" href="/api-capabilities/nano-banana2-image">
    0.5K–4K、高吞吐与 Search grounding
  </Card>

  <Card title="Nano Banana Pro API" icon="cherry" href="/api-capabilities/nano-banana-pro-image">
    复杂构图、专业成片与 4K
  </Card>

  <Card title="在线测试" icon="play" href="https://yingtu.ai">
    先验证提示词和效果，再接入代码
  </Card>
</CardGroup>