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.
Utilisez RunAPI pour générer une vidéo avec MiniMax Hailuo 02 Pro via Hermes Agent.
Exigences :
- Utiliser le fournisseur custom:runapi déjà configuré dans Hermes Agent
- Appeler l'endpoint text_to_video de RunAPI à https://runapi.ai/api/v1/hailuo/text_to_video
- Définir le modèle sur "hailuo-02-text-to-video-pro"
- La variable d'environnement RUNAPI_API_KEY fournit l'autorisation
- Inclure un prompt détaillé décrivant le mouvement de caméra et la scène
- La réponse est asynchrone — interroger l'endpoint de statut de tâche jusqu'à ce que la tâche se termine, puis récupérer l'URL de la vidéo
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."
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "hailuo-02-text-to-video-pro"
}
Utiliser Hailuo dans Hermes Agent en trois étapes
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/hailuo/text_to_video
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.
GET /api/v1/hailuo/text_to_video/tsk_abc123
Paramètres API de Hailuo
| Paramètre | 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. |
Qu'est-ce que Hailuo sur Hermes Agent ?
Hailuo de MiniMax délivre la vitesse de génération la plus rapide de sa catégorie avec une cohérence de mouvement fluide et une forte conservation des détails. Via le fournisseur custom:runapi de Hermes Agent, il produit des séquences 1080p natives à partir de texte ou d'images, Hailuo 2.3 ajoutant des styles de rendu dédiés pour l'anime et les illustrations. Sa vitesse en fait un choix pratique pour les workflows nécessitant rapidement plusieurs variations vidéo.
Cas d'utilisation de Hailuo
Contenu de chaîne YouTube sans visage
Générer des plans d'établissement et des séquences visuelles pour des chaînes YouTube sans visage. Le délai de traitement rapide de Hailuo et la qualité de sortie cohérente le rendent pratique pour la production régulière de contenu.
Clips produit et e-commerce
Créer des vidéos de présentation produit avec une physique réaliste -- liquides qui coulent, tissus qui drapent, objets qui pivotent -- pour les pages de listing et les publicités sociales.
Plans d'établissement et B-roll
Générer des séquences de fond et des clips de transition pour des projets vidéo plus longs. Hailuo gère le rendu d'environnement, les effets atmosphériques et le mouvement de caméra de manière fiable.
Questions sur Hailuo + 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.
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.
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.
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.
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.
Configuration générale de Hermes Agent
Pas encore configuré ? Commencez par le guide de configuration RunAPI pour Hermes Agent.
Guide de configuration Hermes Agent →Catalogue des modèles Hailuo
Voir toutes les variantes de Hailuo, les niveaux de tarification et la documentation API.
Modèles Hailuo →Essayez Hailuo dans Hermes Agent dès aujourd'hui.
Obtenez une clé RunAPI gratuite, configurez le fournisseur custom:runapi et commencez à générer des vidéos avec MiniMax Hailuo.