--- title: 透過 RunAPI 在 WorkBuddy 中使用 Nano Banana — MCP 指南 | RunAPI description: 透過 MCP 在 WorkBuddy 中使用 Google Nano Banana 生成圖片。精準文字算繪、最高 4K 輸出，以及透過一把 RunAPI key 使用 Pro/2/Edit variants。 url: https://runapi.ai/zh-TW/workbuddy-nano-banana.md canonical: https://runapi.ai/zh-TW/workbuddy-nano-banana locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-nano-banana zh-CN: https://runapi.ai/zh-CN/workbuddy-nano-banana es: https://runapi.ai/es/workbuddy-nano-banana ja: https://runapi.ai/ja/workbuddy-nano-banana de: https://runapi.ai/de/workbuddy-nano-banana fr: https://runapi.ai/fr/workbuddy-nano-banana pt-BR: https://runapi.ai/pt-BR/workbuddy-nano-banana ko: https://runapi.ai/ko/workbuddy-nano-banana it: https://runapi.ai/it/workbuddy-nano-banana nl: https://runapi.ai/nl/workbuddy-nano-banana pl: https://runapi.ai/pl/workbuddy-nano-banana tr: https://runapi.ai/tr/workbuddy-nano-banana zh-TW: https://runapi.ai/zh-TW/workbuddy-nano-banana zh-HK: https://runapi.ai/zh-HK/workbuddy-nano-banana ar: https://runapi.ai/ar/workbuddy-nano-banana x-default: https://runapi.ai/workbuddy-nano-banana model: nano-banana --- > HTML version: https://runapi.ai/zh-TW/workbuddy-nano-banana > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Nano Banana。 Nano Banana 是 Google 的 Gemini-native 圖片生成 model，在生成圖片中的文字算繪表現業界領先。Pro 最高可輸出 4K resolution，Nano Banana 2 針對速度與延伸 aspect ratios 最佳化，而 Edit 可修改既有圖片。WorkBuddy 透過一個 RunAPI server 與一把 RUNAPI_API_KEY，將全部三個 variants 作為 MCP tools 存取。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · text to image + edit tools · 最高 4K 輸出 ### 提示詞 ```text Use the runapi MCP server to generate an image with Google Nano Banana Pro. Requirements: - Call the runapi create_task tool with service "nano_banana" and action "text_to_image". - Set the model to "nano-banana-pro". - Write a descriptive prompt. Nano Banana excels at rendering text within images, so include any text overlays in the prompt. - Optionally set output_resolution to "4k" for maximum quality. - The task is async. Poll it with get_task until it completes. - When the task is complete, report the image URL from the task output. ``` ### MCP 設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 回應 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "nano-banana-pro", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png", "output_resolution": "4k" } } ``` ## 三個步驟在 WorkBuddy 中使用 Nano Banana 1. **新增 RunAPI MCP server** - 在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 讀取您的 key。若 RunAPI 已連線供 chat 使用，同一個 server 也會提供 Nano Banana image tools。 `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **要求 WorkBuddy 執行 Nano Banana 任務** - 提示工作台 agent 以 service nano_banana 與 action text_to_image 呼叫 runapi create_task tool；使用 nano-banana-pro 取得最高品質、nano-banana-2 取得速度，或使用 nano-banana 作為基礎 variant。若要取得最大細節，請在 Pro 或 2 上將 output_resolution 設為 4k。若要編輯，將 action 改為搭配 nano-banana-edit 和 image_url 的 edit_image。 `create_task(service="nano_banana", action="text_to_image", model="nano-banana-pro", prompt="...", output_resolution="4k") ` 3. **取得結果** - tool call 會回傳 task_id。WorkBuddy 透過 get_task tool 輪詢，直到 status 變更為 completed，接著將生成的圖片 URL 回報至工作台對話中。 `get_task(service="nano_banana", task_id="tsk_abc123") ` ## Nano Banana 任務參數 | 參數 | 類型 | 說明 | | --- | --- | --- | | `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 為必填，文字轉圖片版本會忽略此參數。 | | `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` | 選填。task 完成時接收 POST 的 webhook URL。 | ## WorkBuddy 上的 Nano Banana 是什麼？ Nano Banana 是 Google 的圖片生成 model，使用者稱其為 2026 年圖片生成「好得嚇人」且「預設首選」的模型。Pro variant 提供人們所說的「Flash 速度下的 Pro 級品質」— 它登上 LM Arena leaderboard，並產出縮小與手動設計工具世代差距的成果。WorkBuddy agents 可透過同一個 RunAPI MCP server，使用一把 key 且無需額外 plugins 來呼叫全部三個 variants。 ## Nano Banana 使用情境 - **室內設計渲染** - 生成數百種房間佈局變體，具備精確的家具擺放與燈光效果，取代設計迭代中的手動 3D 渲染。 - **登陸頁主視覺圖片** - 在 WorkBuddy 中根據文字 brief 建立 hero images 與社群廣告視覺，圖片 URL 會直接回傳至工作台。 - **附有精確字體排版的書籍封面** - 生成書籍封面設計，正確呈現書名與作者名稱，字體排版是圖片的一部分，而非事後疊加。 ## Nano Banana + WorkBuddy 問題 ### Nano Banana Pro、2 與基礎版有何差異？ Nano Banana Pro 提供最高圖片品質與最高 4K output resolution。Nano Banana 2 針對速度最佳化，並支援 1:4 與 8:1 等額外 aspect ratios，適合橫幅和長直式格式。基礎 nano-banana variant 是標準 resolution 下最實惠的選項。三者都在 runapi MCP server 上共用相同的 text_to_image action。 ### Nano Banana 能在生成的圖片中呈現可讀文字嗎？ 可以。Nano Banana 專為圖片中的精確文字呈現而設計。請在提示詞中加入您想要的確切文字——模型原生處理字體放置與易讀性，不同於大多數會扭曲字形的擴散模型。 ### Nano Banana 4K 輸出定價如何運作？ Nano Banana Pro 的定價依 output_resolution 而異：1k 與 2k 費率相同，4k 每張圖片費用較高。Nano Banana 2 採用類似的階層結構。請至 RunAPI 定價頁面查看確切的每張圖片費率。無月費最低消費門檻。 ### 我可以在 WorkBuddy 中使用 Nano Banana 編輯既有圖片嗎？ 可以。要求 WorkBuddy 使用 nano-banana-edit model 執行 edit_image 任務。透過 image_url 傳入來源圖片，並在 prompt 中描述所需變更。edit variant 支援文字感知修改，因此您可以在既有圖片上新增或變更文字疊加。 ### Nano Banana 在 WorkBuddy 中是 async 還是 sync？ Async。create_task tool 會立即回傳 task_id，WorkBuddy 以 get_task 輪詢直到圖片準備完成 — 您只會在對話中看到完成的 URL。task 完成時，也可以透過 callback_url 傳送 webhook。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未設定嗎？請先參閱適用於 WorkBuddy 的 RunAPI MCP 設定指南。 - [Nano Banana 模型 →](https://runapi.ai/zh-TW/models/nano-banana.md) - 查看所有 Nano Banana 版本、定價及 API 文件。 ## 立即在 WorkBuddy 中試用 Nano Banana。 取得免費 RunAPI key，將 MCP server 加入 WorkBuddy，並以最高 4K resolution 生成具備精準文字算繪的圖片。 [瀏覽模型 →](https://runapi.ai/zh-TW/models.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": "適用於 WorkBuddy 的 RunAPI Nano Banana", "applicationCategory": "DeveloperApplication", "description": "透過 MCP 在 WorkBuddy 中使用 Google Nano Banana 生成圖片。精準文字算繪、最高 4K 輸出，以及透過一把 RunAPI key 使用 Pro/2/Edit variants。", "url": "https://runapi.ai/zh-TW/workbuddy-nano-banana" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Nano Banana Pro、2 與基礎版有何差異？", "acceptedAnswer": { "@type": "Answer", "text": "Nano Banana Pro 提供最高圖片品質與最高 4K output resolution。Nano Banana 2 針對速度最佳化，並支援 1:4 與 8:1 等額外 aspect ratios，適合橫幅和長直式格式。基礎 nano-banana variant 是標準 resolution 下最實惠的選項。三者都在 runapi MCP server 上共用相同的 text_to_image action。" } }, { "@type": "Question", "name": "Nano Banana 能在生成的圖片中呈現可讀文字嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。Nano Banana 專為圖片中的精確文字呈現而設計。請在提示詞中加入您想要的確切文字——模型原生處理字體放置與易讀性，不同於大多數會扭曲字形的擴散模型。" } }, { "@type": "Question", "name": "Nano Banana 4K 輸出定價如何運作？", "acceptedAnswer": { "@type": "Answer", "text": "Nano Banana Pro 的定價依 output_resolution 而異：1k 與 2k 費率相同，4k 每張圖片費用較高。Nano Banana 2 採用類似的階層結構。請至 RunAPI 定價頁面查看確切的每張圖片費率。無月費最低消費門檻。" } }, { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 Nano Banana 編輯既有圖片嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。要求 WorkBuddy 使用 nano-banana-edit model 執行 edit_image 任務。透過 image_url 傳入來源圖片，並在 prompt 中描述所需變更。edit variant 支援文字感知修改，因此您可以在既有圖片上新增或變更文字疊加。" } }, { "@type": "Question", "name": "Nano Banana 在 WorkBuddy 中是 async 還是 sync？", "acceptedAnswer": { "@type": "Answer", "text": "Async。create_task tool 會立即回傳 task_id，WorkBuddy 以 get_task 輪詢直到圖片準備完成 — 您只會在對話中看到完成的 URL。task 完成時，也可以透過 callback_url 傳送 webhook。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Nano Banana", "description": "在 WorkBuddy 中將 RunAPI 註冊為 MCP server，要求工作台 agent 執行 Nano Banana text-to-image 或 edit 任務，並讓它輪詢任務直到圖片完成。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP server", "text": "在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 讀取您的 key。若 RunAPI 已連線供 chat 使用，同一個 server 也會提供 Nano Banana image tools。", "url": "https://runapi.ai/zh-TW/workbuddy-nano-banana#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "要求 WorkBuddy 執行 Nano Banana 任務", "text": "提示工作台 agent 以 service nano_banana 與 action text_to_image 呼叫 runapi create_task tool；使用 nano-banana-pro 取得最高品質、nano-banana-2 取得速度，或使用 nano-banana 作為基礎 variant。若要取得最大細節，請在 Pro 或 2 上將 output_resolution 設為 4k。若要編輯，將 action 改為搭配 nano-banana-edit 和 image_url 的 edit_image。", "url": "https://runapi.ai/zh-TW/workbuddy-nano-banana#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "取得結果", "text": "tool call 會回傳 task_id。WorkBuddy 透過 get_task tool 輪詢，直到 status 變更為 completed，接著將生成的圖片 URL 回報至工作台對話中。", "url": "https://runapi.ai/zh-TW/workbuddy-nano-banana#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Nano Banana", "item": "https://runapi.ai/zh-TW/workbuddy-nano-banana" } ] } ] ```