在 Hermes Agent 中使用 Topaz。
Topaz Labs 的 Topaz 使用神經網絡將圖像放大增強至最高 8 倍解析度，恢復細節而不產生偽影。Hermes Agent 透過與聊天和圖像生成相同的 RunAPI 自訂 provider 呼叫它——發送圖像 URL，選擇縮放倍數，然後輪詢增強後的結果。
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"
}
三步驟在 Hermes Agent 中使用 Topaz
設定 RunAPI
如果你尚未在 Hermes Agent 中設定 RunAPI，請參照 Hermes Agent 設定指南。新增名為 runapi 的自訂 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，附上來源圖像 URL（image_url）以及可選的縮放倍數 2、4 或 8。同一個 RunAPI key 處理身份驗證。
POST /api/v1/topaz/upscale_image
輪詢結果
端點返回狀態為 pending 的 task_id。輪詢 task status 端點直到狀態變為 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 中將 RunAPI 設定為自訂 provider，base_url 設為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY，然後指示 agent 呼叫 Topaz upscale_image 端點。用於聊天的同一個 custom:runapi provider 亦可處理放大增強請求。
不需要。支援聊天、圖像生成和其他模型的同一個 RUNAPI_API_KEY 亦適用於 Topaz 放大增強。所有 RunAPI 模型共用一個 API key 和一個點數餘額。
Topaz 放大增強是非同步的。端點立即返回 task_id。你的 Hermes Agent 輪詢 task status 端點直到放大增強後的圖像就緒。RunAPI SDK 和 CLI 會自動處理輪詢。
Topaz 透過 RunAPI 按用量付費，按任務計費。請查看 RunAPI 收費頁面了解最新價格。無月費訂閱或最低消費。