Use Topaz in Hermes Agent.
Topaz by Topaz Labs upscales images up to 8x resolution using neural networks that recover detail without artifacts. Hermes Agent calls it through the same RunAPI custom provider used for chat and image generation — send an image URL, pick a scale factor, and poll for the enhanced result.
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"
}
Use Topaz in Hermes Agent in three steps
Configure RunAPI
If you have not set up RunAPI in Hermes Agent yet, follow the Hermes Agent setup guide. Add a custom provider named runapi with base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY, and api_mode chat_completions.
export RUNAPI_API_KEY=runapi_xxx
Call Topaz upscale_image
Send a POST request to the upscale_image endpoint with model set to topaz-upscale-image, the source image_url, and an optional scale factor of 2, 4, or 8. The same RunAPI key handles authentication.
POST /api/v1/topaz/upscale_image
Poll for the result
The endpoint returns a task_id with status pending. Poll the task status endpoint until the status changes to completed, then retrieve the upscaled image URL from the response. RunAPI SDKs and the CLI handle polling automatically.
GET /api/v1/topaz/upscale_image/tsk_abc123
Topaz upscale_image API parameters
| Parameter | Type | Description |
|---|---|---|
model |
string |
Required. topaz-upscale-image or topaz-upscale-video. |
image_url |
string |
URL of the image to upscale. |
scale |
integer |
Optional. Upscale factor: 2, 4, or 8. Default 2. |
callback_url |
string |
Optional. Webhook URL for async completion notification. |
What is Topaz on Hermes Agent?
Topaz is the essential post-production tool for AI image workflows -- it takes generated images from any model and enhances them to professional quality. Unlike generation models, Topaz does not create new images; it makes existing images sharper, larger, and cleaner. Through RunAPI, Hermes Agent can chain Topaz after any generation step, turning a standard 1K output into a print-ready 8K asset without desktop software.
Topaz use cases
Generation-to-print pipeline
Generate images with Flux 2 or Imagen 4, then upscale with Topaz to 8K in one Hermes Agent workflow -- taking AI output from screen resolution to print-ready quality.
AI artifact cleanup
Fix compression artifacts, noise, and blur in AI-generated images that need polishing before commercial use or client delivery.
Old photograph restoration
Enhance scanned photos, archival images, and historical documents to modern display standards, recovering detail from low-resolution or degraded sources.
Topaz + Hermes Agent questions
Yes. Configure RunAPI as a custom provider in Hermes Agent with base_url https://runapi.ai/v1 and key_env RUNAPI_API_KEY, then instruct the agent to call the Topaz upscale_image endpoint. The same custom:runapi provider used for chat also handles upscaling requests.
No. The same RUNAPI_API_KEY that powers chat, image generation, and other models also works for Topaz upscaling. All RunAPI models share one API key and one credits balance.
Topaz offers configurable 2x/4x/8x scale factors and excels at photographic detail at extreme enlargements. Recraft crisp upscale is optimized for clean edge recovery on design assets with lower per-task cost. For product photos and design work, try Recraft first. For maximum resolution photography, use Topaz.
Topaz works best on photographic content. Heavily compressed images, very small source files, or images with existing AI artifacts may produce results that look plasticky or over-smoothed at high scale factors. Start with 2x to test quality before committing to 4x or 8x on a batch.
Hermes Agent general setup
Not configured yet? Start with the RunAPI setup guide for Hermes Agent.
Hermes Agent setup guide →Try Topaz in Hermes Agent today.
Get a free RunAPI key, configure the custom provider, and start upscaling images with Topaz.