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


# 在 WorkBuddy 中使用 Topaz。

Topaz by Topaz Labs 使用神經網路將圖像放大至最高 4 倍解析度，在不產生失真的情況下還原細節。WorkBuddy 原生支援 MCP——將 RunAPI 加為 MCP server，向 agent 提供圖像 URL 和縮放比例，即可在工作台取得增強結果。

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

一個 MCP 伺服器 · 一個 API key · 代理自動處理異步任務

### 提示詞

```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 server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並在 Authorization 標頭中填入您的 RUNAPI_API_KEY。若 RunAPI 已用於聊天或圖像生成，同一 server 即可使用 Topaz。 `url: https://runapi.ai/mcp`
2. **提示工作台代理** - 將提示連同來源 image_url 貼入 WorkBuddy，將 model 設為 topaz-upscale-image，並可選填 1、2 或 4 的縮放比例。agent 會將您的請求對應至 RunAPI upscale 工具。 `model: topaz-upscale-image`
3. **讓代理返回結果** - 工具呼叫會建立一個狀態為 pending 的非同步任務。WorkBuddy 會替您等待，任務完成後將放大後的圖像 URL 發布至對話中。 `task_id: tsk_abc123`

## Topaz upscale 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 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 呼叫 upscale 工具，將 model 設為 topaz-upscale-image。

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

不需要。runapi MCP server 背後使用的同一個 RUNAPI_API_KEY 亦處理 Topaz 放大。所有 RunAPI 模型共用一個 API 金鑰和一個點數餘額。

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

非同步。工具呼叫會立即返回 task_id，WorkBuddy agent 會代您等待放大圖像就緒，然後在對話中返回 URL——無需手動輪詢。

### Topaz 放大的費用是多少？

Topaz 透過 RunAPI 按任務計費。請查閱 RunAPI 定價頁面了解最新費率。無月費訂閱或最低消費——不同於每年 $199 的 Topaz 桌面應用程式訂閱。

### 某些圖片類型的質素會下降嗎？

Topaz 最適合處理攝影內容。嚴重壓縮的圖片、非常小的來源檔案，或已有 AI 瑕疵的圖片，在高放大倍數下可能呈現塑膠感或過度平滑的效果。建議先以 2x 測試質素，再決定是否以 4x 批次處理。


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

## 立即在 WorkBuddy 中試用 Topaz。

取得免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，即可從工作台使用 Topaz 放大圖像。

[瀏覽模型 →](https://runapi.ai/zh-HK/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-HK/.md)
### 產品
- [模型目錄](https://runapi.ai/zh-HK/models.md)
- [收費](https://runapi.ai/zh-HK/pricing.md)
- [服務商](https://runapi.ai/zh-HK/models#all-models)
### 開發者
- [文件](https://runapi.ai/zh-HK/docs/guides)
- [SDK](https://runapi.ai/zh-HK/sdk.md)
- [CLI](https://runapi.ai/zh-HK/cli.md)
- [MCP Server](https://runapi.ai/zh-HK/mcp.md)
- [x402](https://runapi.ai/zh-HK/x402.md)
### 指南
- [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md)
### 公司
- [企業版](https://runapi.ai/zh-HK/contact.md)
- [聯絡](https://runapi.ai/zh-HK/contact.md)
### 法律
- [條款](https://runapi.ai/zh-HK/terms.md)
- [私隱](https://runapi.ai/zh-HK/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-HK",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-HK",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-HKicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "SoftwareApplication",
    "name": "適用於 WorkBuddy 的 RunAPI Topaz",
    "applicationCategory": "DeveloperApplication",
    "description": "透過 RunAPI MCP server 在 WorkBuddy 中使用 Topaz 放大圖像。一個 API 金鑰，最高 4 倍解析度增強，非同步任務由工作台 agent 處理。",
    "url": "https://runapi.ai/zh-HK/workbuddy-topaz"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@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 呼叫 upscale 工具，將 model 設為 topaz-upscale-image。"
        }
      },
      {
        "@type": "Question",
        "name": "使用 Topaz 需要單獨的 API 金鑰嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。runapi MCP server 背後使用的同一個 RUNAPI_API_KEY 亦處理 Topaz 放大。所有 RunAPI 模型共用一個 API 金鑰和一個點數餘額。"
        }
      },
      {
        "@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-HK",
    "@type": "HowTo",
    "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Topaz",
    "description": "在 WorkBuddy 中將 RunAPI 加為 MCP server，並提示工作台 agent 使用 Topaz upscale 工具提升圖像解析度。",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "新增 RunAPI MCP 伺服器",
        "text": "在 WorkBuddy 中註冊一個名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並在 Authorization 標頭中填入您的 RUNAPI_API_KEY。若 RunAPI 已用於聊天或圖像生成，同一 server 即可使用 Topaz。",
        "url": "https://runapi.ai/zh-HK/workbuddy-topaz#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "提示工作台代理",
        "text": "將提示連同來源 image_url 貼入 WorkBuddy，將 model 設為 topaz-upscale-image，並可選填 1、2 或 4 的縮放比例。agent 會將您的請求對應至 RunAPI upscale 工具。",
        "url": "https://runapi.ai/zh-HK/workbuddy-topaz#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "讓代理返回結果",
        "text": "工具呼叫會建立一個狀態為 pending 的非同步任務。WorkBuddy 會替您等待，任務完成後將放大後的圖像 URL 發布至對話中。",
        "url": "https://runapi.ai/zh-HK/workbuddy-topaz#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "主頁",
        "item": "https://runapi.ai/zh-HK"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "適用於 WorkBuddy 的 RunAPI Topaz",
        "item": "https://runapi.ai/zh-HK/workbuddy-topaz"
      }
    ]
  }
]
```
