Minimax H3 Text-to-Video
- Génération depuis un texte non vide
- Durée de sortie :
5à15secondes ; seul2kest actuellement pris en charge - Aucune entrée image, vidéo ou audio
- Traitement asynchrone ; consultez la tâche avec son ID
- Les URL générées restent valides 24 heures
Autorisations
Toutes les interfaces necessitent une authentification par Bearer Token
Obtenir une cle API :
Visitez la Page de gestion des cles API pour obtenir votre cle API
Ajoutez dans l'en-tete de la requete :
Corps
Nom du modele de generation video
minimax-h3-text-to-video "minimax-h3-text-to-video"
Décrivez la vidéo à générer.
Exigences du prompt :
- Obligatoire et non vide
- Le chinois et l’anglais sont pris en charge
- Il est recommandé de ne pas dépasser
500caractères chinois ou1000mots anglais ; un prompt trop long peut amener le modèle à ignorer certains détails
Restrictions d’entrée :
- Ce modèle génère une vidéo uniquement à partir de texte
image_start,image_end,image_urls,video_urlsetaudio_urlsne sont pas pris en charge- L’envoi de l’un de ces champs multimédias renvoie une erreur de paramètre
1"Bande-annonce de space opera épique : une capitaine se tient seule devant une immense baie d’observation tandis que la dernière flotte se rassemble au-dehors. La flotte disparaît dans un saut aveuglant et la passerelle tremble ; lorsque la lumière s’éteint, elle reste seule dans le silence de l’espace. Éclairage cinématographique, lent travelling avant, atmosphère grandiose mais retenue."
Durée de la vidéo de sortie en secondes. Valeur par défaut : 5 secondes.
Valeurs autorisées :
- Uniquement les entiers de
5à15, bornes incluses - Les décimales, chaînes numériques,
autoet-1ne sont pas pris en charge - La durée de sortie influe directement sur la facturation
5 <= x <= 155
Résolution de la vidéo de sortie. Valeur par défaut : 2k.
Valeur disponible :
2k: seule résolution actuellement prise en charge
Remarques :
768pn’est pas encore disponible et renvoie une erreur de paramètre- Le débit, la fréquence d’images et les codecs vidéo et audio sont déterminés par la plateforme et ne sont pas configurables
2k "2k"
Format de la vidéo de sortie. Valeur par défaut : adaptive.
Valeurs disponibles :
adaptive: le modèle choisit un format adapté au prompt21:9: ultra-large16:9: paysage4:3: paysage standard1:1: carré3:4: portrait standard9:16: portrait
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 "adaptive"
URL de rappel HTTPS apres l'achevement de la tache
Declenchement du rappel :
- Declenche lorsque la tache est terminee (completed) ou echouee (failed)
- Envoye apres la confirmation de la facturation
Restrictions de securite :
- Seul le protocole HTTPS est pris en charge
- Les rappels vers les adresses IP privees sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- La longueur de l'URL ne doit pas depasser
2048caracteres
Mecanisme de rappel :
- Delai d'expiration :
10secondes - Jusqu'a
3tentatives apres un echec (respectivement1/2/4secondes apres l'echec) - Le format du corps de reponse du rappel est identique a celui de l'interface de consultation de tache
- Un code de statut 2xx est considere comme un succes, les autres codes declenchent une nouvelle tentative
^https://"https://your-domain.com/webhooks/video-task-completed"
Réponse
Tache de generation video creee avec succes
Horodatage de creation de la tache
1761313744
ID de la tache
"task-unified-1774857405-abc123"
Nom du modele effectivement utilise
"minimax-h3-text-to-video"
Type specifique de la tache
video.generation.task Pourcentage de progression de la tache (0-100)
0 <= x <= 1000
Statut de la tache
pending, processing, completed, failed "pending"
Informations detaillees de la tache video
Type de sortie de la tache
text, image, audio, video "video"
Informations d'utilisation et de facturation