---
title: "Use Topaz in Hermes Agent via RunAPI — AI Image Upscaling API Guide"
url: "https://runapi.ai/hermes-topaz.md"
canonical: "https://runapi.ai/hermes-topaz"
locale: "en"
model: "topaz"
---

# 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.

## 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. **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.
2. **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.
3. **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.

## 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. |

## FAQ

### Can I use Topaz in Hermes Agent?

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.

### Do I need a separate API key for Topaz?

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.

### How does Topaz upscaling compare to Recraft upscaling on RunAPI?

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.

### Does quality degrade on certain image types?

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.


## Links

- [Hermes Agent setup guide →](https://runapi.ai/hermes-agent)
- [Topaz models →](https://runapi.ai/models/topaz)
- [Model catalog](https://runapi.ai/models)
- [API docs](https://runapi.ai/docs)