---
title: "Utiliser Topaz dans Hermes Agent via RunAPI — Guide API Upscaling d'Images IA"
url: "https://runapi.ai/fr/hermes-topaz.md"
canonical: "https://runapi.ai/fr/hermes-topaz"
locale: "fr"
model: "topaz"
---

# Utiliser Topaz dans Hermes Agent.

Topaz de Topaz Labs upscale les images jusqu'à 8x de résolution en utilisant des réseaux de neurones qui récupèrent les détails sans artefacts. Hermes Agent l'appelle via le même fournisseur personnalisé RunAPI utilisé pour le chat et la génération d'images — envoyez une URL d'image, choisissez un facteur d'échelle et interrogez pour le résultat amélioré.

## 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. **Configurer RunAPI** — Si vous n'avez pas encore configuré RunAPI dans Hermes Agent, suivez le guide de configuration Hermes Agent. Ajoutez un fournisseur personnalisé nommé runapi avec base_url https://runapi.ai/v1, key_env RUNAPI_API_KEY et api_mode chat_completions.
2. **Appeler Topaz upscale_image** — Envoyez une requête POST à l'endpoint upscale_image avec le modèle topaz-upscale-image, l'image_url source et un facteur d'échelle optionnel de 2, 4 ou 8. La même clé RunAPI gère l'authentification.
3. **Interroger pour le résultat** — L'endpoint retourne un task_id avec le statut pending. Interrogez l'endpoint de statut de tâche jusqu'à ce que le statut passe à completed, puis récupérez l'URL de l'image upscalée depuis la réponse. Les SDK RunAPI et le CLI gèrent le polling automatiquement.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. topaz-upscale-image ou topaz-upscale-video. |
| `image_url` | `string` | URL de l'image à upscaler. |
| `scale` | `integer` | Optionnel. Facteur d'upscaling : 2, 4 ou 8. Par défaut 2. |
| `callback_url` | `string` | Optionnel. URL webhook pour la notification de completion asynchrone. |

## FAQ

### Puis-je utiliser Topaz dans Hermes Agent ?

Oui. Configurez RunAPI comme fournisseur personnalisé dans Hermes Agent avec base_url https://runapi.ai/v1 et key_env RUNAPI_API_KEY, puis demandez à l'agent d'appeler l'endpoint upscale_image de Topaz. Le même fournisseur custom:runapi utilisé pour le chat gère également les requêtes d'upscaling.

### Ai-je besoin d'une clé API distincte pour Topaz ?

Non. La même RUNAPI_API_KEY qui alimente le chat, la génération d'images et les autres modèles fonctionne également pour l'upscaling Topaz. Tous les modèles RunAPI partagent une seule clé API et un seul solde de crédits.

### L'upscaling Topaz est-il asynchrone ou synchrone ?

L'upscaling Topaz est asynchrone. L'endpoint retourne immédiatement un task_id. Votre Hermes Agent interroge l'endpoint de statut de tâche jusqu'à ce que l'image upscalée soit prête. Les SDK RunAPI et le CLI gèrent le polling automatiquement.

### Quel est le coût de l'upscaling Topaz ?

Topaz utilise une tarification à l'usage par tâche via RunAPI. Consultez la page des tarifs RunAPI pour les tarifs actuels. Il n'y a pas d'abonnement mensuel ni de dépense minimum.


## Links

- [Guide de configuration Hermes Agent →](https://runapi.ai/fr/hermes-agent)
- [Modèles Topaz →](https://runapi.ai/fr/models/topaz)
- [Model catalog](https://runapi.ai/fr/models)
- [API docs](https://runapi.ai/fr/docs)