---
title: "Usa Topaz in Hermes Agent tramite RunAPI — Guida API Upscaling Immagini AI"
url: "https://runapi.ai/it/hermes-topaz.md"
canonical: "https://runapi.ai/it/hermes-topaz"
locale: "it"
model: "topaz"
---

# Usa Topaz in Hermes Agent.

Topaz di Topaz Labs esegue l'upscaling delle immagini fino a 8x di risoluzione usando reti neurali che recuperano i dettagli senza artefatti. Hermes Agent lo chiama tramite lo stesso provider RunAPI personalizzato usato per chat e generazione di immagini — invia un URL dell'immagine, scegli un fattore di scala e attendi il risultato migliorato.

## 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. **Configura RunAPI** — Se non hai ancora configurato RunAPI in Hermes Agent, segui la guida di configurazione di Hermes Agent. Aggiungi un provider personalizzato chiamato runapi con base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY e api_mode chat_completions.
2. **Chiama Topaz upscale_image** — Invia una richiesta POST all'endpoint upscale_image con model impostato su topaz-upscale-image, il source image_url e un fattore di scala facoltativo di 2, 4 o 8. La stessa API key RunAPI gestisce l'autenticazione.
3. **Attendi il risultato** — L'endpoint restituisce un task_id con stato pending. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine con upscaling dalla risposta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. topaz-upscale-image o topaz-upscale-video. |
| `image_url` | `string` | URL dell'immagine da ridimensionare. |
| `scale` | `integer` | Facoltativo. Fattore di upscaling: 2, 4 o 8. Predefinito 2. |
| `callback_url` | `string` | Facoltativo. URL webhook per la notifica di completamento asincrono. |

## FAQ

### Posso usare Topaz in Hermes Agent?

Sì. Configura RunAPI come provider personalizzato in Hermes Agent con base_url https://runapi.ai/v1 e key_env RUNAPI_API_KEY, poi istruisci l'agente a chiamare l'endpoint Topaz upscale_image. Lo stesso provider custom:runapi usato per la chat gestisce anche le richieste di upscaling.

### Ho bisogno di una API key separata per Topaz?

No. La stessa RUNAPI_API_KEY che alimenta chat, generazione di immagini e altri modelli funziona anche per l'upscaling Topaz. Tutti i modelli RunAPI condividono una sola API key e un saldo crediti.

### L'upscaling Topaz è asincrono o sincrono?

L'upscaling Topaz è asincrono. L'endpoint restituisce immediatamente un task_id. Il tuo Hermes Agent esegue il polling dell'endpoint di stato del task finché l'immagine con upscaling non è pronta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

### Quanto costa l'upscaling Topaz?

Topaz usa prezzi pay-as-you-go per task tramite RunAPI. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Non c'è abbonamento mensile o spesa minima.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Topaz →](https://runapi.ai/it/models/topaz)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)