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 :

Modes de génération

MiniMax-H3 sélectionne automatiquement le mode correspondant à partir des champs de la requête. Vous n’avez pas besoin d’un champ mode :
Exclusion mutuelle stricte : les champs image-vers-vidéo (first_frame_image / last_frame_image, et first_frame / last_frame dans image_with_roles) ne peuvent pas être combinés avec les champs de référence multimodale (image_urls, video_urls, audio_urls, et reference_image dans image_with_roles). Les mélanger renvoie 400.
L’audio seul n’est pas autorisé. Si vous passez audio_urls, vous devez également fournir au moins une image de référence ou une vidéo de référence.

Paramètres de la requête

Champs généraux

string
requis
Valeur fixe : MiniMax-H3
model est obligatoire et doit être envoyé explicitement. Les clients déjà intégrés à Hailuo peuvent basculer en définissant model sur MiniMax-H3.
string
requis
Description du contenu de la vidéo. Obligatoire et non vide dans tous les scénarios, maximum 7000 caractères par requête.Décrivez la scène, le sujet, le mouvement et le style en détail pour de meilleurs résultats.Exemple : "A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
défaut:"5"
Durée de sortie (secondes)
  • Plage : entier de 4 à 15
  • Par défaut : 5
string
défaut:"2K"
Résolution de la vidéo
  • Valeur prise en charge : 2K uniquement (par défaut)
string
Rapport d’aspect. Vous pouvez également passer size ou ratio avec le même effet.Rapports autorisés : 21:9, 16:9, 4:3, 1:1, 3:4, 9:16Le comportement selon le scénario est décrit dans « Règles de rapport d’aspect » ci-dessous.
boolean
défaut:"false"
Ajouter un filigrane AIGCPar défaut : falseAlias compatible : aigc_watermark
string
URL qui reçoit une notification lorsque la tâche atteint un état terminal (succès / échec)
Utilisez webhook. Ne passez pas le callback_url officiel. callback_url est réservé à un usage interne et n’est pas accepté de la part des utilisateurs.

Champs image-vers-vidéo

Pour l’image-vers-vidéo première / dernière trame, spécifiez les rôles explicitement. Ne pas déduire à partir du nombre d’éléments dans image_urls.
string
URL de l’image de première trameLorsqu’elle est fournie, cette image est utilisée comme trame de départ de la vidéo.
string
URL de l’image de dernière trameLorsqu’elle est fournie, cette image est utilisée comme trame de fin. Combinez avec first_frame_image pour le contrôle première+dernière trame.

Champs de référence multimodale

string[]
Tableau d’URLs d’images de référence
Chaque image dans image_urls est traitée comme une image de référence (reference_image), quel que soit le nombre. Elles ne sont jamais mappées automatiquement en première / première+dernière trame selon la longueur.
  • Nombre : ≤ 9
string[]
Tableau d’URLs de vidéos de référence
  • Nombre : ≤ 3
  • Format et limites : voir « Limites des médias d’entrée » ci-dessous
string[]
Tableau d’URLs d’audio de référence
  • Nombre : ≤ 3
  • Ne peut pas être utilisé seul ; doit être associé à une image de référence ou une vidéo de référence

Tableau d’images partagé (forme optionnelle)

object[]
Tableau d’images étiquetées par rôle. Peut remplacer first_frame_image / last_frame_image / image_urls. Chaque élément :Exemple (première + dernière trame) :
Exemple (image de référence) :

Règles de rapport d’aspect

Rapports concrets autorisés : 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Limites des médias d’entrée

Taille totale du corps de la requête ≤ 64 MB. Utilisez des URLs publiques pour les fichiers volumineux ; n’utilisez pas Base64.

Images

Vidéo (référence multimodale uniquement)

Audio (référence multimodale uniquement)

Contraintes des paramètres

Les violations sont rejetées avec 400 (le contenu sensible peut renvoyer 422) et ne sont pas facturées :

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

Exemples de requêtes

Cas 1 : Texte-vers-vidéo

Cas 2 : Image-vers-vidéo — Première trame

Cas 3 : Image-vers-vidéo — Première + dernière trame

Cas 4 : Référence multimodale vers vidéo

Cas 5 : Première + dernière trame via image_with_roles

Interroger les résultats de la tâcheLa génération vidéo est asynchrone et 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.Intervalle de polling recommandé : toutes les 5 ~ 10 secondes. Timeout client : 15 minutes. En cas de succès, result.videos[0].url est l’URL mp4. Les URLs vidéo expirent en environ 24 heures — enregistrez-les rapidement. Les tâches échouées sont automatiquement remboursées.