---
title: "Utiliser Z Image dans Hermes Agent via RunAPI — Guide API Image"
url: "https://runapi.ai/fr/hermes-z-image.md"
canonical: "https://runapi.ai/fr/hermes-z-image"
locale: "fr"
model: "z-image"
---

# Utiliser Z Image dans Hermes Agent.

Z Image est le modèle de génération d'images rapide d'Alibaba avec rendu de texte bilingue en chinois et en anglais. Hermes Agent l'appelle via l'endpoint de fournisseur personnalisé RunAPI — même base_url et même clé API que celles utilisées pour le chat, aucun plugin supplémentaire ni location GPU requise.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **Configurer RunAPI** — Définissez votre clé API RunAPI comme variable d'environnement. Si vous avez déjà configuré RunAPI comme fournisseur personnalisé dans Hermes Agent, la même clé et la même base_url fonctionnent pour la génération d'images.
2. **Appeler Z Image** — Envoyez une requête POST à l'endpoint text_to_image avec le modèle z-image et un prompt textuel. Z Image supporte les prompts en chinois et en anglais avec rendu de texte précis.
3. **Obtenir le résultat** — L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche jusqu'à ce que le statut passe à completed, puis récupérez l'URL de l'image générée depuis la sortie de la réponse.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. Utilisez z-image. |
| `prompt` | `string` | Description textuelle. Supporte le chinois et l'anglais. |
| `negative_prompt` | `string` | Optionnel. Ce à éviter dans l'image. |
| `size` | `string` | Optionnel. Dimensions de sortie, ex. 1024x1024. |

## FAQ

### Puis-je utiliser Z Image dans Hermes Agent ?

Oui. Si vous avez RunAPI configuré comme fournisseur personnalisé dans Hermes Agent, la même clé API et la même base_url gèrent les requêtes Z Image. Envoyez un POST à l'endpoint text_to_image avec le modèle z-image.

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

Non. La même RUNAPI_API_KEY que vous utilisez pour le chat et les autres modèles fonctionne également pour Z Image. Tous les modèles RunAPI partagent une seule clé et un seul solde de crédits.

### Z Image est-il asynchrone ou synchrone ?

Z Image est asynchrone. L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche ou utilisez un webhook de rappel pour savoir quand l'image est prête. Les SDK RunAPI gèrent le polling automatiquement.

### Quel est le coût de Z Image ?

Z Image utilise une tarification à l'usage avec facturation par tâche. Consultez la page des tarifs RunAPI pour le tarif actuel. 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 Z Image →](https://runapi.ai/fr/models/z-image)
- [Model catalog](https://runapi.ai/fr/models)
- [API docs](https://runapi.ai/fr/docs)