可以在 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 定价页面获取最新价格。没有月度订阅或最低消费。

HERMES + TOPAZ

在 Hermes Agent 中使用 Topaz。

Topaz 由 Topaz Labs 出品，使用神经网络将图像超分辨率至最高 8 倍，无伪影地恢复细节。Hermes Agent 通过与聊天和图像生成相同的 RunAPI custom provider 调用它——发送图像 URL，选择缩放倍数，轮询获取增强结果。

获取 API Key 阅读文档

一个 API key · 图像超分辨率端点 · 异步任务轮询

Use RunAPI to upscale an image with Topaz.

Requirements:
- Use the RUNAPI_API_KEY environment variable for authentication.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- 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

工作原理

三步在 Hermes Agent 中使用 Topaz

配置 RunAPI

如果你尚未在 Hermes Agent 中配置 RunAPI，请参考 Hermes Agent 配置指南。添加一个名为 runapi 的 custom provider，设置 base_url 为 https://runapi.ai/v1，key_env 为 RUNAPI_API_KEY，api_mode 为 chat_completions。

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。

Hermes Agent 上的 Topaz 是什么？

Topaz 是 AI 图像工作流中不可或缺的后期制作工具——它接收任何模型生成的图像并提升至专业品质。通过 RunAPI，Hermes Agent 可在任何生成步骤之后串联 Topaz，将标准 1K 输出变为可印刷的 8K 资产，无需桌面软件。

Topaz 使用场景

生成转印刷流水线

在一个 Hermes Agent 工作流中先用 Flux 2 或 Imagen 4 生成图像，再用 Topaz 放大至 8K——将 AI 输出从屏幕分辨率提升至印刷品质。

AI 图像瑕疵清除

修复 AI 生成图像中的压缩瑕疵、噪点和模糊，以便在商业用途或交付客户前进行润色。

老照片修复

将扫描照片、档案图片和历史文献提升至现代展示标准，从低分辨率或退化的来源中还原细节。

常见问题

Topaz + Hermes Agent 常见问题

Hermes Agent 通用配置

还没配置？从 Hermes Agent 的 RunAPI 配置指南开始。

Hermes Agent 配置指南 →

Topaz 模型目录

查看所有 Topaz 变体、价格和 API 文档。

Topaz 模型 →

立即在 Hermes Agent 中试用 Topaz。

获取免费 RunAPI key，配置 custom provider，开始使用 Topaz 超分辨率图像。

浏览模型 →