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

# Utiliser Hailuo dans OpenClaw.

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. Les agents OpenClaw l'appellent via RunAPI avec la même clé API utilisée 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à configuré RunAPI comme fournisseur OpenClaw pour le chat, la même clé fonctionne 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

### 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 non disponibles dans le 02.

### Puis-je définir le premier et le dernier plan d'une vidéo ?

Oui, mais uniquement sur les endpoints image-to-video de Hailuo 02. Passez first_frame_image_url et last_frame_image_url ensemble. Hailuo 2.3 image-to-video n'accepte que first_frame_image_url.

### Comment fonctionne la tarification Pro vs Standard ?

Hailuo 02 Pro text-to-video coûte 57 centimes par génération quelle que soit la durée. Le Standard utilise une tarification basée sur la durée — 30 centimes pour 6 secondes, 50 centimes pour 10 secondes. La tarification image-to-video standard tient également compte de output_resolution.

### Hailuo est-il asynchrone ou synchrone ?

Asynchrone. L'API retourne immédiatement un task_id. Interrogez l'endpoint de statut de tâche ou définissez un callback_url pour recevoir un webhook lorsque la vidéo est prête. Le temps de génération typique est de 60 à 120 secondes.

### Quelle résolution Hailuo produit-il ?

Hailuo 02 Pro sort en 1080p natif. Le Standard sort en 512p ou 768p selon le paramètre output_resolution. Les variantes Hailuo 2.3 supportent 768p ou 1080p. Aucun upscaling post-traitement n'est appliqué.


## Links

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