---
title: "在爱马仕 (Hermes Agent) 中通过 RunAPI 使用 Topaz — AI 图像超分辨率 API 指南"
url: "https://runapi.ai/zh-CN/hermes-topaz.md"
canonical: "https://runapi.ai/zh-CN/hermes-topaz"
locale: "zh-CN"
model: "topaz"
---

# 在 Hermes Agent 中使用 Topaz。

Topaz 由 Topaz Labs 出品，使用神经网络将图像超分辨率至最高 8 倍，无伪影地恢复细节。Hermes Agent 通过与聊天和图像生成相同的 RunAPI custom provider 调用它——发送图像 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** — 如果你尚未在 Hermes Agent 中配置 RunAPI，请参考 Hermes Agent 配置指南。添加一个名为 runapi 的 custom provider，设置 base_url 为 https://runapi.ai/v1，key_env 为 RUNAPI_API_KEY，api_mode 为 chat_completions。
2. **调用 Topaz upscale_image** — 向 upscale_image 端点发送 POST 请求，将 model 设为 topaz-upscale-image，提供源图像的 image_url，以及可选的 2、4 或 8 倍缩放因子。同一个 RunAPI key 处理身份验证。
3. **轮询结果** — 端点返回状态为 pending 的 task_id。轮询任务状态端点，直到状态变为 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

### 可以在 Hermes Agent 中使用 Topaz 吗？

可以。在 Hermes Agent 中将 RunAPI 配置为 custom provider，设置 base_url 为 https://runapi.ai/v1，key_env 为 RUNAPI_API_KEY，然后指示 agent 调用 Topaz upscale_image 端点。用于聊天的同一个 custom:runapi provider 也可以处理超分辨率请求。

### Topaz 需要单独的 API key 吗？

不需要。用于聊天、图像生成和其他模型的同一个 RUNAPI_API_KEY 也适用于 Topaz 超分辨率。所有 RunAPI 模型共享一个 API key 和一个点数余额。

### Topaz 超分辨率是异步还是同步的？

异步。端点立即返回 task_id。Hermes Agent 轮询任务状态端点，直到超分辨率图像就绪。RunAPI SDK 和 CLI 会自动处理轮询。

### Topaz 超分辨率的价格是多少？

Topaz 通过 RunAPI 按任务按量计费。查看 RunAPI 定价页面获取最新价格。没有月度订阅或最低消费。


## Links

- [Hermes Agent 配置指南 →](https://runapi.ai/zh-CN/hermes-agent)
- [Topaz 模型 →](https://runapi.ai/zh-CN/models/topaz)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [API docs](https://runapi.ai/zh-CN/docs)