---
title: "透過 RunAPI 在 Hermes Agent 中使用 Nano Banana — 圖片 API 指南"
url: "https://runapi.ai/zh-TW/hermes-nano-banana.md"
canonical: "https://runapi.ai/zh-TW/hermes-nano-banana"
locale: "zh-TW"
model: "nano-banana"
---

# 在 Hermes Agent 中使用 Nano Banana。

Nano Banana 是 Google 的 Gemini 原生圖片生成模型，在生成圖片中擁有業界領先的文字渲染能力。Pro 版本最高可輸出 4K 解析度，Nano Banana 2 針對速度優化並支援更多寬高比，Edit 版本可修改現有圖片。Hermes Agent 透過 RunAPI 自訂 provider 呼叫所有三個版本 — 不需要 ComfyUI 或 GPU 設定。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A minimalist product card for a coffee brand, the text DARK ROAST in bold sans-serif across the top, a steaming cup below, warm studio lighting",
    "aspect_ratio": "4:3",
    "output_resolution": "4k",
    "output_format": "png"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}

```

## How it works

1. **設定 RunAPI** — 設定 RUNAPI_API_KEY 環境變數。如果你已在 Hermes Agent 中為 chat 將 RunAPI 設定為 custom:runapi provider，相同的 key 和 base_url 即可用於 Nano Banana 圖片生成。
2. **呼叫 Nano Banana** — 發送 POST 請求到 text_to_image 端點，model 設為 nano-banana-pro 以獲得最高品質、nano-banana-2 以獲得速度，或 nano-banana 為基礎版本。在 Pro 或 2 上將 output_resolution 設為 4k 以獲得最大細節。若要編輯，POST 到 edit_image 端點，使用 nano-banana-edit 並附上 image_url。
3. **取得結果** — 回應包含一個 task_id。輪詢任務狀態端點，直到 status 變為 completed。完成的回應包含生成的圖片 URL。RunAPI SDK 和 CLI 會自動處理輪詢。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。nano-banana-pro（最高品質，4K）、nano-banana-2（快速，擴展寬高比）、nano-banana（基礎版）或 nano-banana-edit（編輯）。 |
| `prompt` | `string` | 描述所需圖片的文字。包含你想在圖片中渲染的任何文字 — Nano Banana 原生處理排版。 |
| `image_url` | `string` | 來源圖片 URL。nano-banana-edit 為必填，text_to_image 版本則忽略。 |
| `aspect_ratio` | `string` | 選填。輸出寬高比。Pro 接受：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、auto。Nano Banana 2 額外支援 1:4、1:8、4:1、8:1。 |
| `output_resolution` | `string` | 選填。僅限 Pro 和 2。可接受的值：1k、2k、4k。預設為 1k。 |
| `output_format` | `string` | 選填。輸出檔案格式。可接受的值：png、jpeg、jpg。 |
| `callback_url` | `string` | 選填。任務完成時接收 POST 的 Webhook URL。 |

## FAQ

### Nano Banana Pro、2 和基礎版有什麼差別？

Nano Banana Pro 提供最高圖片品質，最高可達 4K 輸出解析度。Nano Banana 2 針對速度優化，支援額外的寬高比如 1:4 和 8:1，適合橫幅和高型格式。基礎版 nano-banana 是標準解析度中最經濟的選擇。三者共用相同的 text_to_image 端點。

### 如何在 Hermes Agent 中切換 Nano Banana 的文字生成和圖片編輯？

若要文生圖，POST 到 /api/v1/nano_banana/text_to_image 並使用任一生成版本（nano-banana-pro、nano-banana-2 或 nano-banana）。若要編輯，POST 到 /api/v1/nano_banana/edit_image 並使用 nano-banana-edit 模型，附上來源 image_url。兩個端點使用相同的 custom:runapi provider 和 RUNAPI_API_KEY。

### Nano Banana 4K 輸出的定價如何？

Nano Banana Pro 的定價依 output_resolution 而異：1k 和 2k 費率相同，而 4k 每張圖片費用更高。Nano Banana 2 遵循類似的分層結構。請查看 RunAPI 定價頁面了解確切的每張圖片費率。無最低月費。

### Nano Banana 可以在生成的圖片中渲染可閱讀的文字嗎？

可以。Nano Banana 專為圖片中的精確文字渲染而設計。在 prompt 中包含你想要的確切文字 — 模型原生處理字型排列和可讀性，不像大多數擴散模型會扭曲字型。

### Hermes Agent 需要 ComfyUI 或 GPU 才能使用 Nano Banana 嗎？

不需要。Hermes Agent 透過 RunAPI custom:runapi provider 端點呼叫 Nano Banana。RunAPI 在伺服器端處理所有 GPU 基礎設施。不需要 ComfyUI 工作流程、不需要雲端 GPU 租用、不需要本機 VRAM — 發送 prompt 即可收到圖片 URL。


## Links

- [<span class="translation_missing" title="translation missing: zh-TW.agent_models.hermes_nano_banana.crosslink_agent_label">Crosslink Agent Label</span>](https://runapi.ai/zh-TW/hermes-agent)
- [<span class="translation_missing" title="translation missing: zh-TW.agent_models.hermes_nano_banana.crosslink_model_label">Crosslink Model Label</span>](https://runapi.ai/zh-TW/models/nano-banana)
- [Model catalog](https://runapi.ai/zh-TW/models)
- [API docs](https://runapi.ai/zh-TW/docs)