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 文檔中心