---
title: "Utiliser Grok Imagine dans Hermes Agent via RunAPI — Guide API Image & Vidéo"
url: "https://runapi.ai/fr/hermes-grok-imagine.md"
canonical: "https://runapi.ai/fr/hermes-grok-imagine"
locale: "fr"
model: "grok-imagine"
---

# Utiliser Grok Imagine dans Hermes Agent.

Grok Imagine est la suite de génération d'images et de vidéos de xAI — texte-vers-image, image-vers-image, texte-vers-vidéo et image-vers-vidéo. Hermes Agent l'appelle via le même fournisseur personnalisé RunAPI et la même clé API utilisés pour le chat, sans plugins supplémentaires à installer.

## 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": "grok-imagine-text-to-image",
    "prompt": "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "grok-imagine-text-to-image"
}

```

## How it works

1. **Configurer RunAPI** — Définissez la variable d'environnement RUNAPI_API_KEY dans votre profil shell. Si le fournisseur custom:runapi est déjà configuré dans Hermes Agent pour le chat, la même clé fonctionne pour Grok Imagine — aucune configuration supplémentaire requise.
2. **Appeler Grok Imagine** — Envoyez une requête POST à l'endpoint text_to_image avec le modèle grok-imagine-text-to-image. Incluez votre prompt décrivant l'image. Pour la vidéo, utilisez text_to_video avec grok-imagine-text-to-video.
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 ou de la vidéo depuis la réponse.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. Ex. grok-imagine-text-to-image, grok-imagine-image-to-video. |
| `prompt` | `string` | Description textuelle de la sortie souhaitée. |
| `image_url` | `string` | URL de l'image source pour image-vers-image ou image-vers-vidéo. |
| `aspect_ratio` | `string` | Optionnel. Ratio d'aspect de sortie, ex. 16:9, 1:1. |

## FAQ

### Puis-je utiliser Grok Imagine dans Hermes Agent ?

Oui. Si RunAPI est déjà configuré comme fournisseur personnalisé (custom:runapi) dans Hermes Agent, la même clé API et la même base_url fonctionnent pour Grok Imagine. Définissez le modèle sur grok-imagine-text-to-image et appelez l'endpoint text_to_image.

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

Non. La même RUNAPI_API_KEY que vous utilisez pour le chat et les autres modèles fonctionne également pour Grok Imagine. Une seule clé couvre plus de 113 modèles dans le catalogue RunAPI.

### Grok Imagine est-il asynchrone ou synchrone ?

Asynchrone. L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche jusqu'à ce que la tâche se termine. Les SDK RunAPI et le CLI gèrent le polling automatiquement.

### Quel est le coût de Grok Imagine ?

Grok Imagine utilise une facturation par tâche via RunAPI. Consultez la page des tarifs RunAPI pour les tarifs actuels. Les générations échouées ne sont pas facturées.


## Links

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