---
title: "Utiliser Hailuo dans Hermes Agent via RunAPI — Guide API Vidéo"
url: "https://runapi.ai/fr/hermes-hailuo.md"
canonical: "https://runapi.ai/fr/hermes-hailuo"
locale: "fr"
model: "hailuo"
---

# Utiliser Hailuo dans Hermes Agent.

Hailuo est le modèle de génération vidéo de MiniMax produisant des vidéos natives 1080p avec simulation physique précise en 6 variantes — Hailuo 02 et 2.3, chacun avec des endpoints text-to-video et image-to-video en niveaux pro et standard. Hermes Agent l'appelle via RunAPI en utilisant le fournisseur custom:runapi — même clé et URL de base que celles configurées pour le chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **Configurer RunAPI** — Définissez la variable d'environnement RUNAPI_API_KEY. Si vous avez déjà ajouté RunAPI comme fournisseur custom:runapi dans Hermes Agent pour le chat, la même clé et base_url fonctionnent pour la génération vidéo — aucune configuration supplémentaire requise.
2. **Appeler Hailuo text_to_video ou image_to_video** — Envoyez une requête POST à /api/v1/hailuo/text_to_video avec le modèle défini sur hailuo-02-text-to-video-pro et un prompt décrivant la scène. Pour une vidéo ancrée sur une image, utilisez l'endpoint image_to_video avec first_frame_image_url pour préserver le sujet source.
3. **Obtenir le résultat** — L'endpoint 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 la vidéo générée depuis la réponse. Le délai de traitement typique est inférieur à deux minutes pour le niveau pro.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Requis. L'un de : hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
| `prompt` | `string` | Requis. Description textuelle de la scène vidéo, du mouvement de caméra et de l'éclairage. |
| `first_frame_image_url` | `string` | Requis pour les endpoints image_to_video. URL de l'image source utilisée comme premier plan. |
| `last_frame_image_url` | `string` | Optionnel. URL d'une image utilisée comme dernier plan. Disponible uniquement sur Hailuo 02 image-to-video. |
| `duration_seconds` | `integer` | Optionnel. Durée de la vidéo en secondes. Valeurs acceptées : 6 ou 10. Par défaut 10 en standard, fixe en pro. |
| `output_resolution` | `string` | Optionnel. Résolution de sortie. 512p ou 768p pour le standard 02 ; 768p ou 1080p pour les variantes 2.3. |
| `callback_url` | `string` | Optionnel. URL webhook qui reçoit un POST lorsque la tâche se termine. |

## FAQ

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

Oui. Configurez RunAPI comme fournisseur custom:runapi dans Hermes Agent, puis appelez l'endpoint text_to_video ou image_to_video avec un slug de modèle Hailuo. La même RUNAPI_API_KEY utilisée pour le chat gère la génération vidéo.

### Quelle est la différence entre Hailuo 02 et Hailuo 2.3 ?

Hailuo 02 supporte text-to-video et image-to-video avec contrôle du premier et dernier plan. Hailuo 2.3 est uniquement image-to-video mais ajoute un mouvement corporel amélioré, des micro-expressions et des styles de rendu anime et illustration dédiés.

### Comment fonctionne la tarification basée sur la durée pour les niveaux standard ?

La tarification du niveau standard varie selon duration_seconds. Pour text-to-video standard, un clip de 6 secondes coûte 30 centimes et un clip de 10 secondes coûte 50 centimes. La tarification image-to-video standard tient également compte de output_resolution — un clip 6s 512p commence à 12 centimes.

### Hermes Agent gère-t-il automatiquement le polling asynchrone ?

Non. Hailuo est asynchrone — l'API retourne immédiatement un task_id. Votre workflow Hermes Agent doit interroger l'endpoint de statut de tâche ou fournir un callback_url. Le temps de génération typique est de 60 à 120 secondes.

### Puis-je contrôler le premier et le dernier plan d'une vidéo Hailuo ?

Uniquement sur les endpoints image-to-video de Hailuo 02. Passez first_frame_image_url et last_frame_image_url ensemble pour définir les plans de début et de fin. Hailuo 2.3 image-to-video n'accepte que first_frame_image_url.


## Links

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