--- title: 通过 RunAPI 在 WorkBuddy 中使用 Nano Banana — MCP 指南 | RunAPI description: 通过 MCP 在 WorkBuddy 中用 Google Nano Banana 生成图像——精准文本渲染、最高 4K 输出、Pro/2/Edit 三个版本，一个 RunAPI 密钥全部搞定。 url: https://runapi.ai/zh-CN/workbuddy-nano-banana.md canonical: https://runapi.ai/zh-CN/workbuddy-nano-banana locale: zh-CN 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-CN/workbuddy-nano-banana > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Nano Banana Nano Banana 是 Google 基于 Gemini 的图像生成模型，在生成图像的文本渲染方面处于行业领先。Pro 输出最高 4K 分辨率，Nano Banana 2 针对速度优化并支持更多宽高比，Edit 用于修改现有图像。WorkBuddy 通过同一个 RunAPI MCP 服务器和一个 RUNAPI_API_KEY，以工具形式调用全部三个版本。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 文生图 + 编辑工具 · 最高 4K 输出 ### Prompt ```text 使用 runapi MCP 服务器通过 Google Nano Banana Pro 生成图像。 要求： - 调用 runapi 的 create_task 工具，service 设为 "nano_banana"，action 设为 "text_to_image"。 - 将 model 设为 "nano-banana-pro"。 - 编写描述性的提示词。Nano Banana 擅长在图像中渲染文本，请把要出现的文字直接写进提示词。 - 可选：将 output_resolution 设为 "4k" 以获得最高质量。 - 任务是异步的，用 get_task 轮询直到任务完成。 - 完成后，从任务输出中报告图像 URL。 ``` ### MCP 配置 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```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 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 读取。如果 RunAPI 已接入用于聊天，同一个服务器就会暴露 Nano Banana 图像工具。 `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **让 WorkBuddy 发起 Nano Banana 任务** - 提示工作台智能体调用 runapi 的 create_task 工具，service 设为 nano_banana，action 设为 text_to_image；追求最高质量用 nano-banana-pro，追求速度用 nano-banana-2，基础版用 nano-banana。在 Pro 或 2 上把 output_resolution 设为 4k 获得最大细节。如需编辑，把 action 换成 edit_image，使用 nano-banana-edit 并附上 image_url。 `create_task(service="nano_banana", action="text_to_image", model="nano-banana-pro", prompt="...", output_resolution="4k") ` 3. **获取结果** - 工具调用会返回一个 task_id。WorkBuddy 用 get_task 工具轮询，直到状态变为 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 必填，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。 | ## WorkBuddy 上的 Nano Banana 是什么？ Nano Banana 是 Google 的图像生成模型，被用户称为 2026 年图像生成的默认之选。Pro 版本曾打破 LM Arena 排行榜，产出的效果正在缩小与手工设计工具之间的代际差距。WorkBuddy 智能体通过同一个 RunAPI MCP 服务器以工具形式调用全部三个版本，一个密钥，无需额外插件。 ## Nano Banana 使用场景 - **室内设计渲染** - 生成数百个房间布局变体，家具摆放和光照都准确合理，用于设计迭代时可替代手工 3D 渲染。 - **落地页主视觉** - 在 WorkBuddy 里根据文字简报生成落地页主图和社交广告视觉，图像 URL 直接回到工作台。 - **排版精准的书籍封面** - 生成书名和作者名渲染正确的书籍封面设计，文字排版直接融入画面，而不是事后叠加。 ## Nano Banana + WorkBuddy 常见问题 ### Nano Banana Pro、2 和基础版有什么区别？ Nano Banana Pro 提供最高的图像质量，输出分辨率最高可达 4K。Nano Banana 2 针对速度优化，并支持 1:4 和 8:1 等额外宽高比，适合横幅和竖长格式。基础版 nano-banana 是标准分辨率下最经济的选择。三者在 runapi MCP 服务器上共用同一个 text_to_image 动作。 ### 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 模型发起 edit_image 任务，通过 image_url 传入源图像，并在提示词中描述想要的修改。编辑版本支持文本感知的修改，可以在现有图像上添加或更改文字叠加。 ### 在 WorkBuddy 里 Nano Banana 是异步还是同步的？ 异步。create_task 工具会立即返回一个 task_id，WorkBuddy 用 get_task 轮询直到图像就绪——你在对话里直接看到成品 URL。也可以提供 callback_url，在任务完成时接收 Webhook 通知。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未配置？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Nano Banana 模型 →](https://runapi.ai/zh-CN/models/nano-banana.md) - 查看所有 Nano Banana 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 Nano Banana。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，以最高 4K 分辨率生成带精准文本渲染的图像。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI Nano Banana", "applicationCategory": "DeveloperApplication", "description": "通过 MCP 在 WorkBuddy 中用 Google Nano Banana 生成图像——精准文本渲染、最高 4K 输出、Pro/2/Edit 三个版本，一个 RunAPI 密钥全部搞定。", "url": "https://runapi.ai/zh-CN/workbuddy-nano-banana" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Nano Banana Pro、2 和基础版有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "Nano Banana Pro 提供最高的图像质量，输出分辨率最高可达 4K。Nano Banana 2 针对速度优化，并支持 1:4 和 8:1 等额外宽高比，适合横幅和竖长格式。基础版 nano-banana 是标准分辨率下最经济的选择。三者在 runapi MCP 服务器上共用同一个 text_to_image 动作。" } }, { "@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 模型发起 edit_image 任务，通过 image_url 传入源图像，并在提示词中描述想要的修改。编辑版本支持文本感知的修改，可以在现有图像上添加或更改文字叠加。" } }, { "@type": "Question", "name": "在 WorkBuddy 里 Nano Banana 是异步还是同步的？", "acceptedAnswer": { "@type": "Answer", "text": "异步。create_task 工具会立即返回一个 task_id，WorkBuddy 用 get_task 轮询直到图像就绪——你在对话里直接看到成品 URL。也可以提供 callback_url，在任务完成时接收 Webhook 通知。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Nano Banana", "description": "在 WorkBuddy 中将 RunAPI 注册为 MCP 服务器，让工作台智能体发起 Nano Banana 文生图或编辑任务，并轮询任务直到图像就绪。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 读取。如果 RunAPI 已接入用于聊天，同一个服务器就会暴露 Nano Banana 图像工具。", "url": "https://runapi.ai/zh-CN/workbuddy-nano-banana#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "让 WorkBuddy 发起 Nano Banana 任务", "text": "提示工作台智能体调用 runapi 的 create_task 工具，service 设为 nano_banana，action 设为 text_to_image；追求最高质量用 nano-banana-pro，追求速度用 nano-banana-2，基础版用 nano-banana。在 Pro 或 2 上把 output_resolution 设为 4k 获得最大细节。如需编辑，把 action 换成 edit_image，使用 nano-banana-edit 并附上 image_url。", "url": "https://runapi.ai/zh-CN/workbuddy-nano-banana#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "获取结果", "text": "工具调用会返回一个 task_id。WorkBuddy 用 get_task 工具轮询，直到状态变为 completed，然后把生成的图像 URL 报告回工作台对话。", "url": "https://runapi.ai/zh-CN/workbuddy-nano-banana#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI Nano Banana", "item": "https://runapi.ai/zh-CN/workbuddy-nano-banana" } ] } ] ```