---
title: nano-banana-2.1 API — Nano Banana 價格與規格 | RunAPI
description: 透過 RunAPI 使用 nano-banana-2.1——Nano Banana 系列。按次計費、model ID、規格與開發者入門指南。
url: https://runapi.ai/zh-TW/models/nano-banana/2.1.md
canonical: https://runapi.ai/zh-TW/models/nano-banana/2.1
locale: zh-TW
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/models/nano-banana/2.1
  zh-CN: https://runapi.ai/zh-CN/models/nano-banana/2.1
  es: https://runapi.ai/es/models/nano-banana/2.1
  ja: https://runapi.ai/ja/models/nano-banana/2.1
  de: https://runapi.ai/de/models/nano-banana/2.1
  fr: https://runapi.ai/fr/models/nano-banana/2.1
  pt-BR: https://runapi.ai/pt-BR/models/nano-banana/2.1
  ko: https://runapi.ai/ko/models/nano-banana/2.1
  it: https://runapi.ai/it/models/nano-banana/2.1
  nl: https://runapi.ai/nl/models/nano-banana/2.1
  pl: https://runapi.ai/pl/models/nano-banana/2.1
  tr: https://runapi.ai/tr/models/nano-banana/2.1
  zh-TW: https://runapi.ai/zh-TW/models/nano-banana/2.1
  zh-HK: https://runapi.ai/zh-HK/models/nano-banana/2.1
  ar: https://runapi.ai/ar/models/nano-banana/2.1
  x-default: https://runapi.ai/models/nano-banana/2.1
model: Nano Banana
provider: Google
variant_id: nano-banana-2.1
sdk_model_id: nano-banana-2.1
modality: image
billing_unit: 次呼叫
status: maintenance
---

> HTML version: https://runapi.ai/zh-TW/models/nano-banana/2.1
> Site index for agents: https://runapi.ai/llms.txt


# nano-banana-2.1 API

**維護中:** 此模型維護期間暫停 API 呼叫，請稍後重試。

透過 RunAPI 使用 Nano Banana 系列的 nano-banana-2.1。按次計費，無訂閱費，失敗的生成不收費。

**Google / [Nano Banana](https://runapi.ai/zh-TW/models/nano-banana.md)**
**維護中 · image · 可商用**




### 切換 variant

- [nano-banana](https://runapi.ai/zh-TW/models/nano-banana/nano-banana.md)
- [nano-banana-2](https://runapi.ai/zh-TW/models/nano-banana/2.md)
- [nano-banana-2-lite](https://runapi.ai/zh-TW/models/nano-banana/2-lite.md)
- **nano-banana-2.1** (current)
- [nano-banana-edit](https://runapi.ai/zh-TW/models/nano-banana/edit.md)
- [nano-banana-pro](https://runapi.ai/zh-TW/models/nano-banana/pro.md)

6 個版本可用





nano-banana-2.1 在 Nano Banana 系列中，兼顧品質與成本的最佳平衡。

- 以美元按次計費
- 生成失敗不收費
- 模型支援時可串流輸出
- 各模型的請求參數與能力限制
- 只需變更一個 model ID 參數即可切換 variant
- 所有模型與供應商統一計費




## 技術細節

| 欄位 | 值 |
|---|---|
| 提供者 | Google |
| 模型 ID | nano-banana-2.1 |
| 模態 | 圖像 |
| 任務類型 | Asynchronous |
| API 端點 | [/api/v1/nano_banana/text_to_image](https://runapi.ai/zh-TW/docs/api/nano-banana/text-to-image) |
| 計費單位 | 次呼叫 |
| 輸入參數 | aspect_ratio, callback_url, model, output_format, output_resolution, prompt, reference_image_urls |
| 最大解析度 | 1k, 2k, 4k |
| 長寬比 | 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto |
| 輸出格式 | png, jpg |
| 目錄狀態 | 維護中 |



**使用方式**

## 3 個步驟使用此模型

1. **取得 API 金鑰** - 免費註冊後，從控制台建立 nano-banana-2.1 的 API 金鑰。
2. **傳送請求** - 向 /api/v1/nano_banana/text_to_image 傳送 POST 請求，並傳入 nano-banana-2.1 模型 ID 與參數。
3. **取得結果** - 輪詢工作或依照回呼取得已完成的 nano-banana-2.1 結果。



<!-- catalog-model-detail-slot: feature-cards -->

## 此模型提供的功能

- **輸出解析度** — 支援公開 endpoint 架構中的 1k, 2k, 4k。
- **彈性參數** — 可設定 5 個已記錄的參數，包括 aspect_ratio, output_format, output_resolution, prompt, reference_image_urls。
- **Endpoint 覆蓋範圍** — 公開 1 個公共 endpoint：text_to_image。
- **Webhook 傳送** — 非同步任務接受回呼 URL 以接收完成通知。
<!-- /catalog-model-detail-slot: feature-cards -->



## Nano Banana 2.1 價格

| API endpoint | 解析度 | 時長 | 價格 |
|---|---|---|---|
| `text_to_image` | 暫無資料 | 次呼叫 | 價格待定 |



**API 參考**

## 端點規格

| Field | Value |
|---|---|
| 端點 | `POST /api/v1/nano_banana/text_to_image` |
| 模型 ID | `nano-banana-2.1` |
| 工作類型 | `text_to_image` |
| 最長時長 | `暫無資料` |
| 解析度 | `1k, 2k, 4k` |
| 長寬比 | `1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto` |
| 輸出格式 | `PNG, JPG` |
| 平均生成時間 | `暫無資料` |


<!-- catalog-model-detail-slot: request-parameters -->

## 請求參數

### `prompt`

**必填** · `string`

Image description or editing instructions.

### `aspect_ratio`

**選填** · `string`

Output aspect ratio. (1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto)

### `callback_url`

**選填** · `string`

Webhook URL for async notifications.

### `output_format`

**選填** · `string`

Output image format. (png, jpg)

### `output_resolution`

**選填** · `string`

Output image resolution. (1k, 2k, 4k)

### `reference_image_urls`

**選填** · `array`

Up to ten reference image URLs for generation or editing.

<!-- /catalog-model-detail-slot: request-parameters -->

**Request example**

```json
{
  "model": "nano-banana-2.1",
  "prompt": "製作一張勵志海報，以粗體襯線字呈現「Never Give Up」，背景是夕陽下的山脈。"
}
```

### 快速開始 — nano-banana-2.1

相同格式 · variant 固定在 model 中

```sh
npx skills add runapi-ai/nano-banana -g
```

```text
Install the Nano Banana skill for this app:

1. Add runapi-ai/nano-banana with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps with model ID nano-banana-2.1.
4. Confirm the install path when done.
```

### 四步驟使用 nano-banana-2.1

1. **安裝** — 安裝此 model line 的 model skill。
2. **設定** — 將 model 欄位設定為此頁面顯示的完整 model ID。
3. **呼叫** — 使用您的 prompt、inputs 和 callback 設定送出型別化請求。
4. **接收** — 讀取 RunAPI 的 task 回應、webhook callback 或快取輸出 URL。

### nano-banana-2.1 有什麼不同

- **VS NANO-BANANA: nano-banana-2.1** — 1K 解析度；快速基準版本（2025 年 8 月）
- **VS NANO-BANANA-2: nano-banana-2.1** — 以 Gemini 3.1 Flash 為基礎；多角色一致性最佳，4–8 秒
- **VS NANO-BANANA-2-LITE: nano-banana-2.1** — 最快、成本最低的 Nano Banana 圖像模型，適合快速生成與迭代

## 使用情境

**產品攝影**

為缺少棚拍照片的電商型錄，自動生成生活風格產品照片。

**遊戲與概念美術**

在定稿前快速發想場景與角色概念。

**編輯插畫**

大規模生成部落格文章與專欄所需的獨特封面與插圖。



## 關於 Nano Banana 2.1 的常見問題

### 如何選擇 nano-banana-2.1？

傳入 quickstart 顯示的 model ID。

### 這個 variant 的速率限制是多少？

每個金鑰的速率限制會依使用方案而調整。請查看定價頁面以了解目前限制。

### 之後可以切換 variant 嗎？

可以——variant 只是旗標。只要變更 model 參數即可切換。

### 它支援串流嗎？

只要支援串流，RunAPI 就會端到端串流。

### 我該在哪裡回報品質問題？

請在公開 GitHub repo 提交 issue，或寄信給支援。

### 需要獨立的供應商帳戶嗎？

不需要。你的 RunAPI API key 足以存取此 variant 及目錄中的所有其他模型，無需底層供應商帳戶。


### RELATED

- [nano-banana-2-lite](https://runapi.ai/zh-TW/models/nano-banana/2-lite.md) — 由 Google 提供 · $0.03 / 次呼叫
- [nano-banana](https://runapi.ai/zh-TW/models/nano-banana/nano-banana.md) — 由 Google 提供 · $0.03 / 次呼叫
- [nano-banana-edit](https://runapi.ai/zh-TW/models/nano-banana/edit.md) — 由 Google 提供 · $0.03 / 次呼叫
- [nano-banana-2](https://runapi.ai/zh-TW/models/nano-banana/2.md) — 由 Google 提供 · $0.05 / 次呼叫

### 開始使用 Nano Banana 進行開發。

- [建立免費帳戶](https://runapi.ai/zh-TW/login)
- [閱讀快速入門 →](https://runapi.ai/zh-TW/docs/api/nano-banana/text-to-image)
## 正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

[聯絡我們](https://runapi.ai/zh-TW/contact.md)



---

## More from RunAPI

- [Home](https://runapi.ai/zh-TW/.md)
### 產品
- [模型目錄](https://runapi.ai/zh-TW/models.md)
- [價格](https://runapi.ai/zh-TW/pricing.md)
- [提供商](https://runapi.ai/zh-TW/models#all-models)
### 開發者
- [文件](https://runapi.ai/zh-TW/docs/guides)
- [SDK](https://runapi.ai/zh-TW/sdk.md)
- [CLI](https://runapi.ai/zh-TW/cli.md)
- [MCP Server](https://runapi.ai/zh-TW/mcp.md)
- [x402](https://runapi.ai/zh-TW/x402.md)
### 指南
- [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md)
### 公司
- [企業版](https://runapi.ai/zh-TW/contact.md)
- [聯絡我們](https://runapi.ai/zh-TW/contact.md)
### 法律
- [服務條款](https://runapi.ai/zh-TW/terms.md)
- [隱私權](https://runapi.ai/zh-TW/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-TWicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "SoftwareApplication",
    "name": "Nano Banana nano-banana-2.1",
    "applicationCategory": "DeveloperApplication"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://runapi.ai/zh-TW"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Models",
        "item": "https://runapi.ai/zh-TW/models"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Nano Banana",
        "item": "https://runapi.ai/zh-TW/models/nano-banana"
      },
      {
        "@type": "ListItem",
        "position": 4,
        "name": "nano-banana-2.1",
        "item": "https://runapi.ai/zh-TW/models/nano-banana/2.1"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "HowTo",
    "name": "四步驟使用 nano-banana-2.1",
    "description": "透過 RunAPI 使用 nano-banana-2.1——Nano Banana 系列。按次計費、model ID、規格與開發者入門指南。",
    "totalTime": "PT5M",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "安裝",
        "text": "安裝此 model line 的 model skill。",
        "url": "https://runapi.ai/zh-TW/models/nano-banana/2.1#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "設定",
        "text": "將 model 欄位設定為此頁面顯示的完整 model ID。",
        "url": "https://runapi.ai/zh-TW/models/nano-banana/2.1#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "呼叫",
        "text": "使用您的 prompt、inputs 和 callback 設定送出型別化請求。",
        "url": "https://runapi.ai/zh-TW/models/nano-banana/2.1#how-step-3"
      },
      {
        "@type": "HowToStep",
        "position": 4,
        "name": "接收",
        "text": "讀取 RunAPI 的 task 回應、webhook callback 或快取輸出 URL。",
        "url": "https://runapi.ai/zh-TW/models/nano-banana/2.1#how-step-4"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "如何選擇 nano-banana-2.1？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "傳入 quickstart 顯示的 model ID。"
        }
      },
      {
        "@type": "Question",
        "name": "這個 variant 的速率限制是多少？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "每個金鑰的速率限制會依使用方案而調整。請查看定價頁面以了解目前限制。"
        }
      },
      {
        "@type": "Question",
        "name": "之後可以切換 variant 嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以——variant 只是旗標。只要變更 model 參數即可切換。"
        }
      },
      {
        "@type": "Question",
        "name": "它支援串流嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "只要支援串流，RunAPI 就會端到端串流。"
        }
      },
      {
        "@type": "Question",
        "name": "我該在哪裡回報品質問題？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "請在公開 GitHub repo 提交 issue，或寄信給支援。"
        }
      },
      {
        "@type": "Question",
        "name": "需要獨立的供應商帳戶嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。你的 RunAPI API key 足以存取此 variant 及目錄中的所有其他模型，無需底層供應商帳戶。"
        }
      }
    ]
  }
]
```
