Skip to main content
POST

Autorisation

string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à l’en-tête de la requête :

Paramètres de la requête

string
requis
Modèles pris en charge :
  • MiniMax-Hailuo-2.3 — Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast — Hailuo 2.3 Fast (latence réduite)
MiniMax-Hailuo-2.3-Fast :
Avec ce modèle, first_frame_image est obligatoire.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description du contenu de la vidéo (2000 caractères maximum)Décrivez les scènes, actions et styles en détail pour de meilleurs résultats. Prend en charge les commandes de mouvement de caméra (voir la section « Commandes de mouvement de caméra » ci-dessous).Exemple : "A cute kitten running on the grass"
integer
défaut:"6"
Durée de la vidéo (secondes)Options :
  • 6 — vidéo de 6 secondes
  • 10 — vidéo de 10 secondes
Par défaut : 6
Limitation 1080p : à la résolution 1080p, seule la durée de 6 secondes est prise en charge
string
défaut:"768p"
Résolution de la vidéoOptions :
  • 768p — haute définition
  • 1080p — Full HD (uniquement 6 secondes)
Par défaut : 768p
string
Image de première trame de la vidéoDeux formats pris en charge :
  • URL publique : https://example.com/start.jpg
  • Encodage Base64 : data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Lorsqu’elle est fournie, cette image sera utilisée comme première trame de la vidéo
MiniMax-Hailuo-2.3-Fast :
Avec ce modèle, first_frame_image est obligatoire.
boolean
défaut:"true"
Optimiser automatiquement le promptLorsqu’activé, le système optimise automatiquement votre prompt pour de meilleurs résultatsPar défaut : true
boolean
défaut:"false"
Réduire le temps d’optimisation du promptLorsqu’activé, la vitesse de traitement est plus rapide mais la qualité de l’optimisation peut être légèrement affectéePar défaut : false
boolean
défaut:"false"
Ajouter un filigranePar défaut : false

Combinaisons résolution / durée

Commandes de mouvement de caméra

Utilisez la syntaxe [commande] dans le prompt pour contrôler les mouvements de caméra. 15 commandes sont prises en charge : Exemple d’utilisation :

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Cas d’utilisation

Cas 1 : Génération rapide texte-vers-vidéo

Cas 2 : Vidéo 1080p de haute qualité

Cas 3 : Image-vers-vidéo avec première trame

Cas 4 : Commandes de mouvement de caméra

Cas 5 : Mode de prétraitement rapide

Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.