Nano Banana API 指南：透過 TokenLab 進行圖像生成與編輯

Nano Banana API 為開發者提供高吞吐量的圖像生成與編輯功能，可直接透過 TokenLab 的統一 API 層進行存取。本指南將示範如何進行身份驗證、建構請求負載（payload），以及將這些圖像生成管道整合至您的生產應用程式中。

重點摘要

• Nano Banana API 專精於快速圖像生成與精確的編輯任務。
• TokenLab 透過提供單一 SDK 與針對多個模型供應商的統一計費，簡化了整合流程。
• 負載結構需要特定的尺寸、提示詞格式與強度參數，以獲得最佳輸出效果。
• 開發者可直接在 TokenLab 上比較 Nano Banana 與其他業界標準模型的效能與定價指標。

什麼是 Nano Banana API？

Nano Banana API 是一個專為低延遲圖像生成與處理所設計的介面。它適合需要快速原型設計與可擴展生產工作流程，且不想負擔管理自託管擴散模型（diffusion models）開銷的開發者。透過 TokenLab 路由請求，開發者可以存取此模型以及更廣泛的工具套件。

在評估 2026 年最佳 AI 圖像模型 API 時，開發者常將 Nano Banana 與 Stable Diffusion XL 或 Midjourney 等大型模型進行比較。雖然這些模型能為複雜的提示詞提供高保真輸出，但 Nano Banana 專注於執行速度與成本效益。您可以在 TokenLab 模型目錄中查看此模型的技術規格與可用性（觀察日期：2026-07-07）。

透過 TokenLab 進行身份驗證與設定

若要與 Nano Banana API 互動，您必須透過 TokenLab 的閘道路由您的請求。這需要一個 API 金鑰與標準的 HTTP 客戶端。以下檢查清單列出了準備開發環境所需的步驟。

整合檢查清單

• 在 TokenLab 上建立一個活躍的開發者帳戶。
• 從 TokenLab 儀表板產生一個生產環境 API 金鑰。
• 將 API 金鑰儲存為名為 TOKENLAB_API_KEY 的環境變數。
• 安裝 HTTP 客戶端程式庫，例如 Python 的 requests 或 Node.js 的 axios。
• 驗證您的帳戶餘額或計費設定，以確保 API 呼叫不中斷。

完成這些步驟後，請將您的客戶端指向 TokenLab 端點。所有請求的基礎 URL 為 https://api.tokenlab.sh/v1，且 API 金鑰必須在授權標頭（authorization header）中傳遞。

# 驗證身份驗證的 curl 指令範例
curl -X GET "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

使用 Nano Banana API 實作圖像生成

文字轉圖像（Text-to-image）生成是 Nano Banana API 的主要入口點。API 接受包含文字提示詞、所需尺寸與推論參數的 JSON 負載。

若要了解 Nano Banana 的營運成本與其他模型相比如何，請參閱 TokenLab 定價比較指南。由於模型定價可能會根據供應商更新而變動，讀者應在連結來源確認當前價格。

下方的 Python 指令碼示範了如何透過 TokenLab 將文字轉圖像請求傳送至 Nano Banana API。

import os
import requests
import json

def generate_image(prompt, width=512, height=512):
    api_key = os.getenv("TOKENLAB_API_KEY")
    if not api_key:
        raise ValueError("TOKENLAB_API_KEY 環境變數未設定。")

    url = "https://api.tokenlab.sh/v1/images/generations"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    
    payload = {
        "model": "nano-banana",
        "prompt": prompt,
        "width": width,
        "height": height,
        "num_inference_steps": 30,
        "guidance_scale": 7.5,
        "response_format": "url"
    }

    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        return data["data"][0]["url"]
    else:
        raise Exception(f"API 錯誤 {response.status_code}: {response.text}")

# 使用範例
if __name__ == "__main__":
    prompt_text = "A minimalist studio portrait of a ceramic vase on a wooden table"
    try:
        image_url = generate_image(prompt_text)
        print(f"生成的圖像 URL: {image_url}")
    except Exception as e:
        print(f"生成失敗: {e}")

在建構提示詞時，請使用具描述性且具體的名詞。Nano Banana API 會依序處理提示詞權重，這意味著放在提示詞開頭的詞彙對最終輸出的影響力，大於放在結尾的詞彙。

圖像編輯與局部重繪（Inpainting）工作流程

除了標準的文字轉圖像生成外，Nano Banana API 還支援圖像轉圖像（image-to-image）修改與局部重繪。這些工作流程需要一張初始來源圖像；若是局部重繪，還需要一張黑白遮罩（mask）來指示要修改的區域。

若要執行圖像轉圖像任務，您必須提供 base64 編碼字串或公開可存取的 URL 作為來源圖像。strength 參數決定了模型對原始圖像的修改程度。強度值為 0.0 時，來源圖像保持不變；而值為 1.0 時，則會完全捨棄原始結構，轉而採用新的提示詞。

# 圖像轉圖像編輯的概念性負載結構
edit_payload = {
    "model": "nano-banana",
    "prompt": "Add a blue sky with soft white clouds",
    "image": "data:image/jpeg;base64,...", # Base64 編碼的來源圖像
    "strength": 0.6,
    "guidance_scale": 8.0
}

對於局部重繪任務，遮罩圖像必須與來源圖像的尺寸相符。遮罩中的白色像素代表要重繪的區域，而黑色像素則保持鎖定。這種方法對於電子商務應用非常有效，例如在保持產品本身完整的情況下更換產品照片的背景。

若要開始將此模型整合至您的技術堆疊中，請立即開始使用 TokenLab。

比較 Nano Banana 與替代 API

選擇正確的模型取決於您的應用程式在延遲、輸出品質與成本方面的具體需求。下表比較了 Nano Banana API 與業界其他知名模型。

模型 / API	主要使用案例	關鍵優勢	定價參考來源
Nano Banana API	快速圖像生成與編輯	低延遲、簡單的負載結構	TokenLab 模型（觀察日期：2026-07-07）
Google Gemini (Imagen)	多模態任務與高解析度生成	企業級安全性、Google 生態系統整合	Google AI 定價（觀察日期：2026-07-07）
Stable Diffusion	高度可自訂的生成	開源靈活性、自訂 LoRA 支援	TokenLab 圖像類別

對於建構複雜系統的開發者來說，比較 API 路由器也是關鍵的一步。您可以閱讀我們的 OpenRouter 比較，以了解多供應商 API 閘道如何管理路由與故障轉移。

如果您的應用程式需要靜態圖像以外的功能，您可能需要查看 2026 年最佳 AI 影片模型 API，或探索 2026 年最佳 AI 程式設計模型，以支援您的開發工作流程。

在 TokenLab 上比較圖像模型，為您的應用程式找到速度、成本與品質的最佳平衡點。

常見問題 (FAQ)

Nano Banana API 支援的最大解析度是多少？

Nano Banana API 原生支援最高 1024x1024 像素的解析度。雖然您可以請求非正方形的長寬比（例如 16:9 或 4:3），但將總像素數保持在接近原生解析度的範圍內，有助於防止出現重複主體等視覺偽影。

TokenLab 如何處理 Nano Banana API 的速率限制？

TokenLab 會根據您的帳戶等級動態管理速率限制。如果您的應用程式超過了每分鐘允許的請求數，API 將會回傳 429 Too Many Requests 狀態碼。建議在您的 HTTP 客戶端中實作指數退避（exponential backoff）機制，以優雅地處理這些限制。

我可以使用 Nano Banana 進行商業應用嗎？

可以，透過 TokenLab 使用 Nano Banana API 所生成的圖像通常已獲准用於商業用途。然而，開發者必須確保其輸入的提示詞與來源圖像不會侵犯第三方智慧財產權，或違反平台的合理使用政策。