Famille Hailuo (MiniMax)

Les modèles de génération vidéo Hailuo de MiniMax, au nombre de deux, s’appellent via l’endpoint vidéo d’OfoxAI POST /v1/videos. Les tâches s’exécutent de façon asynchrone : la création d’une tâche renvoie un ID de tâche, qui sert ensuite à récupérer le résultat.

Quel modèle choisir

Les deux modèles prennent en charge le texte-vers-vidéo, l’image-vers-vidéo et la vidéo de référence, et peuvent générer une piste audio synchronisée (generate_audio vaut true par défaut). adaptive reprend le format de l’image d’entrée.

Le tableau ci-dessus correspond aux video_attributes renvoyés par la Models API ; en cas d’évolution des capacités d’un modèle, la réponse de l’API fait foi. La facturation se fait à la seconde, le coût réel étant donné par usage.video_cost dans le résultat de la tâche ; les prix figurent sur la page du modèle .

Exemples d’appel

Les exemples ci-dessous ne montrent que la requête de création de tâche. Le déroulement complet (interrogation du statut puis téléchargement du résultat) est décrit dans Video API · Démarrage rapide.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Plan en format large : une voiture vintage roule vers le soleil couchant sur une route du désert",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "La personne de l’image se retourne et s’éloigne",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Conserver le mouvement de caméra et transformer l’image en animation au lavis",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images et input_references ne peuvent pas être envoyés ensemble ; les envoyer ensemble renvoie 400 references_conflict.
• Si vous n’avez pas besoin de piste audio, passez "generate_audio": false.
• La description complète des champs figure dans Créer une tâche vidéo.

Valeurs de résolution

Les niveaux de résolution de Hailuo diffèrent de ceux des autres familles : 768p et 2k (k minuscule). Passer 720p ou 1080p, courants dans les autres familles, renvoie 400.

Erreurs courantes

Les codes d’erreur complets figurent dans Codes d’erreur de la Video API.

Documentation officielle

• Documentation de la plateforme ouverte MiniMax 
• OfoxAI · Créer une tâche vidéo

FAQ