Nano Banana 2 开发文档全攻略：官方 API 与 API易接入 2 套方案对比

作者注：Nano Banana 2（gemini-3.1-flash-image-preview）开发文档详解，对比谷歌官方 API 和 API易平台 2 套接入方案，含完整代码示例、参数配置和省钱策略

想接入 Nano Banana 2 的开发者，现在有两份开发文档可以参考：谷歌官方文档（ai.google.dev/gemini-api/docs/image-generation）和 API易 平台文档（docs.apiyi.com/api-capabilities/nano-banana-2-image）。

两套方案各有优势——官方文档功能最全，API易 文档接入最简单且价格低至 $0.03/次。本文将两份文档的核心内容整合对比，帮你选择最适合的接入方式。

核心价值：读完本文，你将掌握 Nano Banana 2 的完整 API 参数、两套接入方案的代码示例、以及不同场景下的最优选择。

Nano Banana 2 开发文档核心参数速查

先看最重要的参数配置。无论用哪套方案接入，这些参数都通用：

Nano Banana 2 支持的 14 种宽高比

🎯 开发提示：1:4、4:1、1:8、8:1 是 Nano Banana 2 独有的新宽高比，Nano Banana Pro 不支持。如果你的应用需要长条幅 Banner 或信息长图，只能使用 gemini-3.1-flash-image-preview。

Nano Banana 2 接入方案 A：谷歌官方 API

官方 API 基础调用

谷歌官方 API 使用 Google Gen AI SDK，支持 Python、JavaScript、Go、Java 和 REST。

from google import genai
from google.genai import types

client = genai.Client()

# 基础文生图
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="一只橘猫在秋天的落叶中打滚，暖色调",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# 提取生成的图片
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# 完整参数配置：2K分辨率 + 16:9宽屏 + High思考模式
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="科技公司年度报告封面，标题 'AI Vision 2026'，深蓝色调，极简风格",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# 解析响应（含 Thinking 过程）
for part in response.parts:
    if part.thought and part.text:
        print(f"[思考过程] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("图片已保存")

官方 API 的 Image Search 联网生成

这是 Nano Banana 2 的独家能力——生成前检索谷歌图片搜索获取真实视觉参考：

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="2026年最新款特斯拉Model Y，银色，停在城市街头",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 注意：Image Search 联网生成有展示要求——必须提供指向源图片网页的可点击链接。Thinking token 无论是否返回推理过程，都会计费。

Nano Banana 2 接入方案 B：API易平台

API易平台接入优势

API易 OpenAI 兼容格式调用

如果你已有基于 OpenAI SDK 的代码，只需改两行即可接入 Nano Banana 2：

import openai

client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "水墨山水画，留白构图，远山云雾缭绕"}]
)

import requests
import base64

API_KEY = "YOUR_APIYI_KEY"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "电商促销海报，大字标题'春季特惠'，红色主题"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# 解码保存图片
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("图片生成成功，成本约 $0.03")

建议：通过 API易 apiyi.com 注册获取 API Key，即可开始调用。平台支持 OpenAI 兼容格式和谷歌原生格式两种调用方式，一个 Key 可切换所有模型。

Nano Banana 2 两套方案价格对比

Nano Banana 2 月成本对比（每天 1000 张）

API易的 $0.03/次不仅比官方标准价便宜 55%，甚至比官方 Batch 半价（$0.034）还要低——而且是实时返回，不需要等待 24 小时的异步处理。

🎯 省钱方案：通过 API易 apiyi.com 调用 Nano Banana 2，每天 1000 张仅需 $30，月成本 $900。注册即送免费测试额度，一个 Key 同时支持 Nano Banana 2、Pro 和其他主流模型。

Nano Banana 2 高级功能开发指南

多轮对话图片编辑

Nano Banana 2 支持在对话中持续修改同一张图片：

# API易 + OpenAI 格式的多轮编辑
messages = [
    {"role": "user", "content": "生成一个简约风格的品牌Logo，蓝色系"},
    # 第一轮返回后继续编辑
    {"role": "assistant", "content": "[第一轮生成结果]"},
    {"role": "user", "content": "把颜色改成渐变紫色，加上公司名称 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Nano Banana 2 参考图片生成

Nano Banana 2 Thinking 模式选择

🎯 开发提示：Thinking token 无论是否设置 includeThoughts=true，都会产生计费。如果不需要查看推理过程，保持默认的 false 即可——不会影响生成质量，只是不返回中间推理文本。

Nano Banana 2 生成速度参考

建议：调用 Nano Banana 2 时建议设置 timeout=300（300 秒），避免因网络波动或谷歌算力波动导致超时失败。通过 API易 apiyi.com 调用可获得更稳定的连接。

常见问题

总结

Nano Banana 2 开发文档的核心要点：

1. 两套方案各有优势：谷歌官方 API 功能最全（Image Search、Thinking、14 张参考图），API易 价格最低（$0.03/次）且接入最简单
2. API易 $0.03 = 官方 45%：实时返回，比官方 Batch 半价（$0.034）还便宜，无需等 24 小时
3. 核心参数通用：4 档分辨率、14 种宽高比、Thinking 模式等参数在两套方案中均可使用

对于大多数开发者，推荐通过 API易 apiyi.com 快速接入 Nano Banana 2——$0.03/次的价格、OpenAI 兼容格式、注册送免费额度，5 分钟内即可生成第一张图片。

📚 参考资料

1. 谷歌官方 Gemini 图片生成文档: Nano Banana 2 完整 API 参考

   • 链接: ai.google.dev/gemini-api/docs/image-generation
   • 说明: 所有参数、功能和高级特性的官方文档

2. API易 Nano Banana 2 文档: 快速接入和代码示例

   • 链接: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • 说明: API易 平台的接入指南，含定价和调用示例

3. Gemini API 官方定价: 各分辨率精确价格

   • 链接: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • 说明: 0.5K/1K/2K/4K 标准价和 Batch 价

4. Gemini API 速率限制: Preview 模型调用限制

   • 链接: ai.google.dev/gemini-api/docs/rate-limits
   • 说明: 了解 Preview 模型的配额限制

作者: APIYI 技术团队
技术交流: 欢迎在评论区分享你的 Nano Banana 2 开发经验，更多 AI 模型资料可访问 API易 docs.apiyi.com 文档中心