# Nano Banana Pro 使用介绍

> 最后更新: 2026-03-27  
> 模型版本: gemini-3-pro-image-preview  
> 发布机构: Google DeepMind

## 1. 基础概览

### 1.1 工具简介
Nano Banana Pro（官方名称：Gemini 3 Pro Image）是 Google DeepMind 推出的专业级 AI 图像生成与编辑模型。

### 1.2 核心特性
- 支持 4K 超高分辨率
- 多语言高保真文本渲染
- 最多 14 张参考图输入
- 基于 Gemini 3 Pro 的高级推理
- 集成 Google Search 实时知识检索
- 专业级参数控制

### 1.3 访问渠道
- Gemini App: 免费额度 + 付费
- Google AI Studio: $0.134-0.24/张
- API: gemini-3-pro-image-preview

## 2. 技术规格

### 2.1 模型信息
- 官方名称: Gemini 3 Pro Image
- 模型 ID: gemini-3-pro-image-preview
- SDK 最低版本: Python 1.52.0, JS/TS 1.30
- Python 版本要求: 3.11+

### 2.2 分辨率选项
- 1K: 标准分辨率 ($0.134)
- 2K: 高分辨率 ($0.134)
- 4K: 超高分辨率 ($0.24)

### 2.3 支持的宽高比
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

### 2.4 输入限制
- 最大图片输入: 14张
- 支持格式: PNG, JPEG, WebP

## 3. 核心功能

### 3.1 完美文本渲染
支持多语言文本（英文、中文、日文、西班牙文等），可生成复杂的排版布局。

### 3.2 思考过程（Thinking Process）
模型在生成前会进行推理，用户可查看其思考过程。

### 3.3 搜索接地（Search Grounding）
连接 Google 搜索获取实时数据，生成准确的信息图表。

### 3.4 4K 超高分辨率
支持多种分辨率选项，满足专业印刷和展示需求。

### 3.5 多图像混合
最多支持 14 张图片输入，保持角色和品牌一致性。

## 4. 安装与配置

### 4.1 获取 API 密钥
1. 访问 https://aistudio.google.com
2. 使用 Google 账号登录
3. 进入 API Key 管理页面
4. 复制 API 密钥

### 4.2 启用计费
Nano Banana Pro 没有免费层级，必须启用计费。

### 4.3 安装 SDK
```bash
# Python
pip install -U "google-genai>=1.52.0"
pip install Pillow

# JavaScript/TypeScript
npm install @google/genai
```

### 4.4 初始化客户端
```python
from google import genai
from google.genai import types

client = genai.Client(api_key="YOUR_API_KEY")
PRO_MODEL_ID = "gemini-3-pro-image-preview"
```

## 5. 使用指南

### 5.1 基础图像生成
```python
response = client.models.generate_content(
    model=PRO_MODEL_ID,
    contents="Create a photorealistic image of a siamese cat",
    config=types.GenerateContentConfig(
        response_modalities=['Text', 'Image'],
        image_config=types.ImageConfig(aspect_ratio="16:9")
    )
)
```

### 5.2 启用思考模式
```python
config=types.GenerateContentConfig(
    thinking_config=types.ThinkingConfig(include_thoughts=True)
)
```

### 5.3 使用搜索接地
```python
config=types.GenerateContentConfig(
    tools=[{"google_search": {}}]
)
```

### 5.4 4K 图像生成
```python
image_config=types.ImageConfig(
    aspect_ratio="1:1",
    image_size="4K"
)
```

## 6. 定价信息
- 1K/2K 图像: $0.134/张
- 4K 图像: $0.24/张
- Batch API: 50% 折扣

## 7. 参考资源
- Google AI Studio: https://aistudio.google.com
- 官方文档: https://ai.google.dev
- API 文档: https://ai.google.dev/gemini-api/docs/image-generation

---
*文档生成时间: 2026-03-27*
