MiniMax-H3
Génération vidéo MiniMax-H3
- Mode de traitement asynchrone, renvoie un ID de tâche pour les requêtes ultérieures
- Prend en charge texte-vers-vidéo, image-vers-vidéo (première / dernière / première+dernière trame) et référence multimodale vers vidéo (images + vidéos + audio de référence)
- Sortie native 2K, durée 4 ~ 15 secondes, avec piste audio
- Partage les mêmes API de soumission et de requête que MiniMax-Hailuo-02 / MiniMax-Hailuo-2.3
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 champmode :
Paramètres de la requête
Champs généraux
string
requis
Valeur fixe :
MiniMax-H3string
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 :
2Kuniquement (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_watermarkstring
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 dansimage_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
- 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 Exemple (image de référence) :
first_frame_image / last_frame_image / image_urls. Chaque élément :Exemple (première + dernière trame) :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.