可以在 OpenClaw 中使用 Topaz 嗎？

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

Topaz 需要單獨的 API key 嗎？

不需要。用於聊天、圖像生成和其他模型的同一個 RUNAPI_API_KEY 也適用於 Topaz 超解析度。所有 RunAPI 模型共享一個 API key 和一個點數餘額。

Topaz 超解析度是非同步還是同步的？

非同步。端點立即傳回 task_id。OpenClaw agent 輪詢任務狀態端點，直到超解析度圖像就緒。RunAPI SDK 和 CLI 會自動處理輪詢。

Topaz 超解析度的價格是多少？

Topaz 透過 RunAPI 按任務按用量計費。請查看 RunAPI 定價頁面取得最新價格。沒有月度訂閱或最低消費。

OPENCLAW + TOPAZ

在 OpenClaw 中使用 Topaz。

Topaz 由 Topaz Labs 出品，使用神經網路將圖像超解析度至最高 8 倍，無偽影地恢復細節。OpenClaw agent 透過與聊天和圖像生成相同的 RunAPI key 呼叫它——發送圖像 URL，選擇縮放倍數，輪詢取得增強結果。

取得 API Key 閱讀說明文件

一個 API key · 圖像超解析度端點 · 非同步任務輪詢

Use RunAPI to upscale an image with Topaz.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Call the RunAPI upscale_image endpoint at https://runapi.ai/api/v1/topaz/upscale_image.
- Set model to "topaz-upscale-image".
- Pass the image URL in image_url.
- Optionally set scale to 2, 4, or 8 (default is 2).
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the upscaled image URL from the result.

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
  }'

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

複製 curl 指令進行測試 topaz

運作原理

三步在 OpenClaw 中使用 Topaz

設定 RunAPI

若尚未在 OpenClaw 中設定 RunAPI，請參考 OpenClaw 設定指南。設定 RUNAPI_API_KEY 環境變數，並將 RunAPI 新增為 OpenAI 相容 provider，設定 baseUrl 為 https://runapi.ai/v1。

export RUNAPI_API_KEY=runapi_xxx

呼叫 Topaz upscale_image

向 upscale_image 端點發送 POST 請求，將 model 設為 topaz-upscale-image，提供來源圖像的 image_url，以及可選的 2、4 或 8 倍縮放因子。同一個 RunAPI key 處理身份驗證。

POST /api/v1/topaz/upscale_image

輪詢結果

端點傳回狀態為 pending 的 task_id。輪詢任務狀態端點，直到狀態變為 completed，然後從回應中取得超解析度後的圖像 URL。RunAPI SDK 和 CLI 會自動處理輪詢。

GET /api/v1/topaz/upscale_image/tsk_abc123

參數

Topaz upscale_image API 參數

參數	類型	說明
`model`	`string`	必填。topaz-upscale-image 或 topaz-upscale-video。
`image_url`	`string`	需要超解析度的圖像 URL。
`scale`	`integer`	選填。超解析度倍數：2、4 或 8，預設為 2。
`callback_url`	`string`	選填。用於非同步完成通知的 webhook URL。

OpenClaw 上的 Topaz 是什麼？

Topaz 是攝影師稱為「相片保真度黃金標準」的專業級圖像修飾工具。它能將圖像放大至最高 8 倍解析度，結果清晰且忠實於原圖——不像某些放大工具會添加原圖中不存在的 AI 生成細節。在 RunAPI 上，它以 API 端點而非桌面應用程式訂閱的形式運行，讓 OpenClaw 代理能將放大功能納入自動化圖像流程的步驟之一。