---
title: 透過 RunAPI 在 WorkBuddy 中使用 Topaz——放大指南 | RunAPI
description: 透過 RunAPI MCP server 在 WorkBuddy 中以 Topaz 放大影像。一組 API key，最高 4x 解析度增強，非同步任務由工作台 agent 處理。
url: https://runapi.ai/zh-TW/workbuddy-topaz.md
canonical: https://runapi.ai/zh-TW/workbuddy-topaz
locale: zh-TW
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-TW/workbuddy-topaz
> Site index for agents: https://runapi.ai/llms.txt


# 在 WorkBuddy 中使用 Topaz。

Topaz by Topaz Labs 使用神經網路將影像放大至最高 4x 解析度，在不產生偽影的情況下還原細節。WorkBuddy 原生支援 MCP——將 RunAPI 新增為 MCP server，提供影像 URL 和縮放倍率給 agent，它便會將增強後的結果回傳至工作台。

- [取得 API Key](https://runapi.ai/zh-TW/login)
- [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides)

一個 MCP server · 一組 API key · 由 agent 處理非同步任務

### 提示詞

```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 server** - 在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並讓 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果 RunAPI 已連線用於聊天或影像生成，同一個 server 已提供 Topaz。 `url: https://runapi.ai/mcp`
2. **提示工作台 agent** - 將包含來源 image_url、model 設為 topaz-upscale-image，以及選填 1、2 或 4 縮放倍率的提示貼到 WorkBuddy。agent 會將您的要求對應至 RunAPI 影像放大工具。 `model: topaz-upscale-image`
3. **讓 agent 傳回結果** - 工具呼叫會建立一個 status 為 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 是專業級影像後製工具，攝影師稱其為「照片擬真度的黃金標準」。它可將影像放大至最高 4x 解析度，呈現清晰透澈且忠於原始影像的結果——不同於某些會添加來源影像中不存在的 AI 生成細節的放大工具。在 RunAPI 上，它以 API 支援的 MCP 工具形式執行，而非桌面應用程式訂閱服務，因此 WorkBuddy agent 可在自動化流程中，於任何生成步驟之後串接影像放大作業。

## Topaz 使用情境

- **將 AI 生成圖片放大至印刷品質** - 將同一個 MCP server 上任一生成模型的輸出放大至 8K 解析度，用於商業印刷授權、大型海報或包裝設計——全部在同一個 WorkBuddy 對話中完成。
- **降噪與人臉修復** - 清除低光環境照片的雜訊，修復人像中模糊的臉部細節，還原因壓縮或拍攝條件不佳而損失的細節。
- **大量照片批次處理** - 請 WorkBuddy 在單次自動化處理中，將數百張產品照片或典藏影像進行放大；每張影像皆會作為獨立的非同步任務處理。

## Topaz + WorkBuddy 常見問題

### 我可以在 WorkBuddy 中使用 Topaz 嗎？

可以。WorkBuddy 原生支援 MCP。將 RunAPI 新增為 MCP server，指向 https://runapi.ai/mcp，並使用您的 RUNAPI_API_KEY，接著要求 agent 呼叫 model 設為 topaz-upscale-image 的放大工具。

### 使用 Topaz 需要單獨的 API 金鑰嗎？

不需要。runapi MCP server 使用的同一組 RUNAPI_API_KEY 也可處理 Topaz 放大。所有 RunAPI 模型共用一組 API key 與同一份 credits 餘額。

### Topaz 放大是非同步還是同步？

非同步。工具呼叫會立即回傳 task_id，WorkBuddy agent 會代您等待放大後的影像完成，接著在對話中回傳 URL——無須手動輪詢。

### Topaz 放大如何計費？

Topaz 透過 RunAPI 採按任務計費。請查看 RunAPI 定價頁面以取得目前費率。沒有月費訂閱或最低消費限制——不同於每年 $199 的 Topaz 桌面應用程式訂閱。

### 特定圖片類型的品質會降低嗎？

Topaz 最適合處理攝影內容。高度壓縮的圖片、尺寸極小的來源檔案，或已含有 AI 瑕疵的圖片，在高倍數放大時可能產生塑膠感或過度平滑的結果。建議先以 2x 測試品質，再對整批圖片使用 4x。


- [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。
- [Topaz 模型 →](https://runapi.ai/zh-TW/models/topaz.md) - 查看所有 Topaz 版本、定價及 API 文件。

## 立即在 WorkBuddy 中試用 Topaz。

取得免費 RunAPI key，將 MCP server 加入 WorkBuddy，即可從工作台開始使用 Topaz 放大影像。

[瀏覽模型 →](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 Topaz",
    "applicationCategory": "DeveloperApplication",
    "description": "透過 RunAPI MCP server 在 WorkBuddy 中以 Topaz 放大影像。一組 API key，最高 4x 解析度增強，非同步任務由工作台 agent 處理。",
    "url": "https://runapi.ai/zh-TW/workbuddy-topaz"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "我可以在 WorkBuddy 中使用 Topaz 嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。WorkBuddy 原生支援 MCP。將 RunAPI 新增為 MCP server，指向 https://runapi.ai/mcp，並使用您的 RUNAPI_API_KEY，接著要求 agent 呼叫 model 設為 topaz-upscale-image 的放大工具。"
        }
      },
      {
        "@type": "Question",
        "name": "使用 Topaz 需要單獨的 API 金鑰嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。runapi MCP server 使用的同一組 RUNAPI_API_KEY 也可處理 Topaz 放大。所有 RunAPI 模型共用一組 API key 與同一份 credits 餘額。"
        }
      },
      {
        "@type": "Question",
        "name": "Topaz 放大是非同步還是同步？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "非同步。工具呼叫會立即回傳 task_id，WorkBuddy agent 會代您等待放大後的影像完成，接著在對話中回傳 URL——無須手動輪詢。"
        }
      },
      {
        "@type": "Question",
        "name": "Topaz 放大如何計費？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Topaz 透過 RunAPI 採按任務計費。請查看 RunAPI 定價頁面以取得目前費率。沒有月費訂閱或最低消費限制——不同於每年 $199 的 Topaz 桌面應用程式訂閱。"
        }
      },
      {
        "@type": "Question",
        "name": "特定圖片類型的品質會降低嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Topaz 最適合處理攝影內容。高度壓縮的圖片、尺寸極小的來源檔案，或已含有 AI 瑕疵的圖片，在高倍數放大時可能產生塑膠感或過度平滑的結果。建議先以 2x 測試品質，再對整批圖片使用 4x。"
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "HowTo",
    "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Topaz",
    "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP server，並要求工作台 agent 使用 Topaz 放大工具提升影像解析度。",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "新增 RunAPI MCP server",
        "text": "在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並讓 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果 RunAPI 已連線用於聊天或影像生成，同一個 server 已提供 Topaz。",
        "url": "https://runapi.ai/zh-TW/workbuddy-topaz#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "提示工作台 agent",
        "text": "將包含來源 image_url、model 設為 topaz-upscale-image，以及選填 1、2 或 4 縮放倍率的提示貼到 WorkBuddy。agent 會將您的要求對應至 RunAPI 影像放大工具。",
        "url": "https://runapi.ai/zh-TW/workbuddy-topaz#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "讓 agent 傳回結果",
        "text": "工具呼叫會建立一個 status 為 pending 的非同步任務。WorkBuddy 會替您等待，任務完成後將放大後的影像 URL 發回對話中。",
        "url": "https://runapi.ai/zh-TW/workbuddy-topaz#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 Topaz",
        "item": "https://runapi.ai/zh-TW/workbuddy-topaz"
      }
    ]
  }
]
```
