在 OpenClaw 中使用 Topaz。
Topaz 由 Topaz Labs 出品，使用神经网络将图像超分辨率至最高 8 倍，无伪影地恢复细节。OpenClaw agent 通过与聊天和图像生成相同的 RunAPI key 调用它——发送图像 URL，选择缩放倍数，轮询获取增强结果。
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"
}
三步在 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 倍分辨率，效果清晰且忠实于原图。在 RunAPI 上它以 API 端点而非桌面软件订阅的形式运行，OpenClaw agent 可将放大功能作为自动化图像流水线的一个步骤。
Topaz 使用场景
AI 生成图放大至印刷质量
将 Midjourney、Flux 或任何生成模型的输出放大至 8K 分辨率，用于商业印刷授权、大幅海报或产品包装。
降噪与面部修复
清除噪点高的弱光照片并修复肖像中模糊的面部，还原因压缩或拍摄条件不佳而丢失的细节。
批量处理大型照片集
在单一流水线中对数百张产品照片或档案图片进行放大处理，API 以异步方式处理每张图像。
Topaz + OpenClaw 常见问题
可以。在 OpenClaw 中将 RunAPI 配置为 OpenAI 兼容 provider，然后指示 agent 调用 Topaz upscale_image 端点。用于聊天和图像生成的同一个 RUNAPI_API_KEY 也可以处理超分辨率请求。
不需要。用于聊天、图像生成和其他模型的同一个 RUNAPI_API_KEY 也适用于 Topaz 超分辨率。所有 RunAPI 模型共享一个 API key 和一个点数余额。
异步。端点立即返回 task_id。OpenClaw agent 轮询任务状态端点，直到超分辨率图像就绪。RunAPI SDK 和 CLI 会自动处理轮询。
Topaz 通过 RunAPI 按任务按量计费。查看 RunAPI 定价页面获取最新价格。没有月度订阅或最低消费。