---
title: "透過 RunAPI 在 OpenClaw 中使用 Topaz — AI 圖像放大增強 API 指南"
url: "https://runapi.ai/zh-HK/openclaw-topaz.md"
canonical: "https://runapi.ai/zh-HK/openclaw-topaz"
locale: "zh-HK"
model: "topaz"
---

# 在 OpenClaw 中使用 Topaz。

Topaz Labs 的 Topaz 使用神經網絡將圖像放大增強至最高 8 倍解析度，恢復細節而不產生偽影。OpenClaw agent 透過與聊天和圖像生成相同的 RunAPI key 呼叫它——發送圖像 URL，選擇縮放倍數，然後輪詢增強後的結果。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/topaz/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "topaz-upscale-image",
    "image_url": "https://example.com/photo.jpg",
    "scale": 4
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "topaz-upscale-image"
}

```

## How it works

1. **設定 RunAPI** — 如果你尚未在 OpenClaw 中設定 RunAPI，請參照 OpenClaw 設定指南。設定 RUNAPI_API_KEY 環境變數，並以 baseUrl https://runapi.ai/v1 將 RunAPI 新增為 OpenAI 相容 provider。
2. **呼叫 Topaz upscale_image** — 向 upscale_image 端點發送 POST 請求，將 model 設為 topaz-upscale-image，附上來源圖像 URL（image_url）以及可選的縮放倍數 2、4 或 8。同一個 RunAPI key 處理身份驗證。
3. **輪詢結果** — 端點返回狀態為 pending 的 task_id。輪詢 task status 端點直到狀態變為 completed，然後從回應中取得放大增強後的圖像 URL。RunAPI SDK 和 CLI 會自動處理輪詢。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。topaz-upscale-image 或 topaz-upscale-video。 |
| `image_url` | `string` | 要放大增強的圖像 URL。 |
| `scale` | `integer` | 可選。放大倍數：2、4 或 8。預設為 2。 |
| `callback_url` | `string` | 可選。非同步完成通知的 webhook URL。 |

## FAQ

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

可以。在 OpenClaw 中將 RunAPI 設定為 OpenAI 相容 provider，然後指示 agent 呼叫 Topaz upscale_image 端點。用於聊天和圖像生成的同一個 RUNAPI_API_KEY 亦可處理放大增強請求。

### 使用 Topaz 需要獨立的 API key 嗎？

不需要。支援聊天、圖像生成和其他模型的同一個 RUNAPI_API_KEY 亦適用於 Topaz 放大增強。所有 RunAPI 模型共用一個 API key 和一個點數餘額。

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

Topaz 放大增強是非同步的。端點立即返回 task_id。你的 OpenClaw agent 輪詢 task status 端點直到放大增強後的圖像就緒。RunAPI SDK 和 CLI 會自動處理輪詢。

### Topaz 放大增強的收費是多少？

Topaz 透過 RunAPI 按用量付費，按任務計費。請查看 RunAPI 收費頁面了解最新價格。無月費訂閱或最低消費。


## Links

- [OpenClaw 設定指南 →](https://runapi.ai/zh-HK/openclaw)
- [Topaz 模型 →](https://runapi.ai/zh-HK/models/topaz)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)