--- title: 在 WorkBuddy 中通过 RunAPI 使用 Topaz — 图像超分辨率指南 | RunAPI description: 通过 RunAPI MCP 服务器在 WorkBuddy 中使用 Topaz 超分辨率图像。一个 API Key，最高 4 倍分辨率增强，异步任务由工作台智能体代办。 url: https://runapi.ai/zh-CN/workbuddy-topaz.md canonical: https://runapi.ai/zh-CN/workbuddy-topaz locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-topaz zh-CN: https://runapi.ai/zh-CN/workbuddy-topaz es: https://runapi.ai/es/workbuddy-topaz ja: https://runapi.ai/ja/workbuddy-topaz de: https://runapi.ai/de/workbuddy-topaz fr: https://runapi.ai/fr/workbuddy-topaz pt-BR: https://runapi.ai/pt-BR/workbuddy-topaz ko: https://runapi.ai/ko/workbuddy-topaz it: https://runapi.ai/it/workbuddy-topaz nl: https://runapi.ai/nl/workbuddy-topaz pl: https://runapi.ai/pl/workbuddy-topaz tr: https://runapi.ai/tr/workbuddy-topaz zh-TW: https://runapi.ai/zh-TW/workbuddy-topaz zh-HK: https://runapi.ai/zh-HK/workbuddy-topaz ar: https://runapi.ai/ar/workbuddy-topaz x-default: https://runapi.ai/workbuddy-topaz model: topaz --- > HTML version: https://runapi.ai/zh-CN/workbuddy-topaz > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Topaz Topaz 由 Topaz Labs 出品，使用神经网络将图像超分辨率至最高 4 倍，无伪影地恢复细节。WorkBuddy 原生支持 MCP 协议——将 RunAPI 添加为 MCP 服务器，把图像 URL 和缩放倍数交给智能体，它就会把增强后的结果带回工作台。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 一个 API Key · 异步任务由智能体代办 ### Prompt ```text Use the runapi MCP server to upscale an image with Topaz. Requirements: - Call the RunAPI upscale tool with model set to "topaz-upscale-image". - Image URL: https://example.com/photo.jpg - Set scale to 4. - Wait until the task completes, then give me the upscaled image URL. ``` ### 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": "topaz-upscale-image", "output": { "image_url": "https://runapi.ai/files/tsk_abc123_4x.png" } } ``` ## 三步在 WorkBuddy 中使用 Topaz 1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 环境变量读取密钥。如果你已为聊天或图像生成连接过 RunAPI，同一个服务器就包含 Topaz。 `url: https://runapi.ai/mcp` 2. **向工作台智能体下达提示词** - 把提示词粘贴到 WorkBuddy，提供源图像的 image_url，将 model 设为 topaz-upscale-image，并可选指定 1、2 或 4 倍的缩放因子。智能体会把你的需求映射到 RunAPI 超分辨率工具上。 `model: topaz-upscale-image` 3. **由智能体交回结果** - 工具调用会创建一个状态为 pending 的异步任务。WorkBuddy 替你处理等待过程，任务完成后把超分辨率后的图像 URL 发回到对话中。 `task_id: tsk_abc123` ## Topaz 超分辨率 API 参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。topaz-upscale-image 或 topaz-upscale-video。 | | `image_url` | `string` | 需要超分辨率的图像 URL。 | | `scale` | `integer` | 可选。超分辨率倍数：1、2 或 4，默认为 2。 | | `callback_url` | `string` | 可选。用于异步完成通知的 webhook URL。 | ## WorkBuddy 上的 Topaz 是什么？ Topaz 是摄影师称为"照片保真度金标准"的专业级图像后期工具。它能将图像放大至 4 倍分辨率，效果清晰且忠实于原图——不像某些放大工具会添加原图中不存在的 AI 生成细节。在 RunAPI 上，它以 API 驱动的 MCP 工具形式运行，而非桌面软件订阅，因此 WorkBuddy 智能体可以在自动化流水线中把放大接在任意生成步骤之后。 ## Topaz 使用场景 - **AI 生成图放大至印刷质量** - 把同一个 MCP 服务器上任意生成模型的输出放大至 8K 分辨率，用于商业印刷授权、大幅海报或产品包装——全部在一次 WorkBuddy 对话中完成。 - **降噪与面部修复** - 清除噪点高的弱光照片并修复肖像中模糊的面部，还原因压缩或拍摄条件不佳而丢失的细节。 - **批量处理大型照片集** - 让 WorkBuddy 在一次自动化流程中对数百张产品照片或档案图片进行放大处理，每张图像都作为独立的异步任务执行。 ## Topaz + WorkBuddy 常见问题 ### 可以在 WorkBuddy 中使用 Topaz 吗？ 可以。WorkBuddy 原生支持 MCP。将 RunAPI 添加为指向 https://runapi.ai/mcp 的 MCP 服务器并填入 RUNAPI_API_KEY，然后让智能体调用超分辨率工具，将 model 设为 topaz-upscale-image。 ### Topaz 需要单独的 API Key 吗？ 不需要。runapi MCP 服务器背后的同一个 RUNAPI_API_KEY 也可以处理 Topaz 超分辨率。所有 RunAPI 模型共享一个 API Key 和一个点数余额。 ### Topaz 超分辨率是异步还是同步的？ 异步。工具调用会立即返回 task_id，WorkBuddy 智能体会替你等到超分辨率图像就绪，然后把 URL 返回到对话中——无需手动轮询。 ### Topaz 超分辨率的价格是多少？ Topaz 通过 RunAPI 按任务按量计费。最新价格请查看 RunAPI 定价页面。没有月度订阅，也没有最低消费——不同于每年 $199 的 Topaz 桌面软件订阅。 ### 某些图像类型的效果会打折扣吗？ Topaz 最适合摄影类内容。压缩严重的图像、尺寸很小的源文件，或已带有 AI 伪影的图像，在高倍放大时可能出现塑料感或过度平滑。批量处理前先用 2 倍测试质量，再决定是否上 4 倍。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 还没连接？从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Topaz 模型 →](https://runapi.ai/zh-CN/models/topaz.md) - 查看所有 Topaz 变体、价格和 API 文档。 ## 立即在 WorkBuddy 中试用 Topaz。 获取免费 RunAPI Key，在 WorkBuddy 中添加 MCP 服务器，直接在工作台内用 Topaz 超分辨率图像。 [浏览模型 →](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 Topaz", "applicationCategory": "DeveloperApplication", "description": "通过 RunAPI MCP 服务器在 WorkBuddy 中使用 Topaz 超分辨率图像。一个 API Key，最高 4 倍分辨率增强，异步任务由工作台智能体代办。", "url": "https://runapi.ai/zh-CN/workbuddy-topaz" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "可以在 WorkBuddy 中使用 Topaz 吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。WorkBuddy 原生支持 MCP。将 RunAPI 添加为指向 https://runapi.ai/mcp 的 MCP 服务器并填入 RUNAPI_API_KEY，然后让智能体调用超分辨率工具，将 model 设为 topaz-upscale-image。" } }, { "@type": "Question", "name": "Topaz 需要单独的 API Key 吗？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。runapi MCP 服务器背后的同一个 RUNAPI_API_KEY 也可以处理 Topaz 超分辨率。所有 RunAPI 模型共享一个 API Key 和一个点数余额。" } }, { "@type": "Question", "name": "Topaz 超分辨率是异步还是同步的？", "acceptedAnswer": { "@type": "Answer", "text": "异步。工具调用会立即返回 task_id，WorkBuddy 智能体会替你等到超分辨率图像就绪，然后把 URL 返回到对话中——无需手动轮询。" } }, { "@type": "Question", "name": "Topaz 超分辨率的价格是多少？", "acceptedAnswer": { "@type": "Answer", "text": "Topaz 通过 RunAPI 按任务按量计费。最新价格请查看 RunAPI 定价页面。没有月度订阅，也没有最低消费——不同于每年 $199 的 Topaz 桌面软件订阅。" } }, { "@type": "Question", "name": "某些图像类型的效果会打折扣吗？", "acceptedAnswer": { "@type": "Answer", "text": "Topaz 最适合摄影类内容。压缩严重的图像、尺寸很小的源文件，或已带有 AI 伪影的图像，在高倍放大时可能出现塑料感或过度平滑。批量处理前先用 2 倍测试质量，再决定是否上 4 倍。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何在 WorkBuddy 中通过 RunAPI 使用 Topaz", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，然后向工作台智能体下达提示词，通过 Topaz 超分辨率工具提升图像分辨率。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 环境变量读取密钥。如果你已为聊天或图像生成连接过 RunAPI，同一个服务器就包含 Topaz。", "url": "https://runapi.ai/zh-CN/workbuddy-topaz#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台智能体下达提示词", "text": "把提示词粘贴到 WorkBuddy，提供源图像的 image_url，将 model 设为 topaz-upscale-image，并可选指定 1、2 或 4 倍的缩放因子。智能体会把你的需求映射到 RunAPI 超分辨率工具上。", "url": "https://runapi.ai/zh-CN/workbuddy-topaz#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "由智能体交回结果", "text": "工具调用会创建一个状态为 pending 的异步任务。WorkBuddy 替你处理等待过程，任务完成后把超分辨率后的图像 URL 发回到对话中。", "url": "https://runapi.ai/zh-CN/workbuddy-topaz#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 Topaz", "item": "https://runapi.ai/zh-CN/workbuddy-topaz" } ] } ] ```