---
title: "Topaz in Hermes Agent via RunAPI verwenden — KI-Bild-Upscaling-API-Anleitung"
url: "https://runapi.ai/de/hermes-topaz.md"
canonical: "https://runapi.ai/de/hermes-topaz"
locale: "de"
model: "topaz"
---

# Topaz in Hermes Agent verwenden.

Topaz von Topaz Labs skaliert Bilder bis zu 8-fach hoch und stellt Details mithilfe neuronaler Netze ohne Artefakte wieder her. Hermes Agent ruft es ueber denselben RunAPI-Custom-Provider wie fuer Chat und Bildgenerierung auf — Bild-URL senden, Skalierungsfaktor waehlen und auf das verbesserte Ergebnis warten.

## 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. **RunAPI konfigurieren** — Wenn RunAPI noch nicht in Hermes Agent eingerichtet ist, der Hermes Agent-Einrichtungsanleitung folgen. Einen Custom-Provider namens runapi mit base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY und api_mode chat_completions hinzufuegen.
2. **Topaz upscale_image aufrufen** — Einen POST-Request an den upscale_image-Endpunkt mit model topaz-upscale-image, der Quell-image_url und einem optionalen Skalierungsfaktor von 2, 4 oder 8 senden. Derselbe RunAPI-Key authentifiziert den Request.
3. **Ergebnis abfragen** — Der Endpunkt gibt eine task_id mit Status pending zurueck. Den Task-Status-Endpunkt abfragen, bis der Status auf completed wechselt, dann die hochskalierte Bild-URL aus der Antwort auslesen. RunAPI SDKs und die CLI uebernehmen das Polling automatisch.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. topaz-upscale-image oder topaz-upscale-video. |
| `image_url` | `string` | URL des hochzuskalierenden Bildes. |
| `scale` | `integer` | Optional. Skalierungsfaktor: 2, 4 oder 8. Standard ist 2. |
| `callback_url` | `string` | Optional. Webhook-URL fuer asynchrone Abschlussbenachrichtigung. |

## FAQ

### Kann ich Topaz in Hermes Agent verwenden?

Ja. RunAPI als Custom-Provider in Hermes Agent mit base_url https://runapi.ai/v1 und key_env RUNAPI_API_KEY konfigurieren, dann den Agenten anweisen, den Topaz upscale_image-Endpunkt aufzurufen. Derselbe custom:runapi-Provider fuer Chat verarbeitet auch Upscaling-Requests.

### Brauche ich einen separaten API-Key fuer Topaz?

Nein. Derselbe RUNAPI_API_KEY fuer Chat, Bildgenerierung und andere Modelle funktioniert auch fuer Topaz-Upscaling. Alle RunAPI-Modelle teilen sich einen API-Key und ein Guthaben.

### Ist Topaz-Upscaling asynchron oder synchron?

Topaz-Upscaling ist asynchron. Der Endpunkt gibt sofort eine task_id zurueck. Der Hermes Agent fragt den Task-Status-Endpunkt ab, bis das hochskalierte Bild fertig ist. RunAPI SDKs und die CLI uebernehmen das Polling automatisch.

### Was kostet Topaz-Upscaling?

Topaz wird ueber RunAPI nutzungsbasiert pro Task abgerechnet. Aktuelle Preise auf der RunAPI-Preisseite. Kein monatliches Abonnement oder Mindestbetrag.


## Links

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