Skip to main content
POST
Minimax H3 Text-to-Video

Autorisations

Authorization
string
header
requis

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

application/json
model
enum<string>
défaut:minimax-h3-text-to-video
requis

Nom du modele de generation video

Options disponibles:
minimax-h3-text-to-video
Exemple:

"minimax-h3-text-to-video"

prompt
string
requis

Décrivez la vidéo à générer.

Exigences du prompt :

  • Obligatoire et non vide
  • Le chinois et l’anglais sont pris en charge
  • Longueur maximale : 7000 caractères (le chinois comme l’anglais sont comptés en caractères)
  • 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_urls et audio_urls ne sont pas pris en charge
  • L’envoi de l’un de ces champs multimédias renvoie une erreur de paramètre
Required string length: 1 - 7000
Exemple:

"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."

duration
integer
défaut:4

Durée de la vidéo de sortie en secondes. Valeur par défaut : 4 secondes.

Valeurs autorisées :

  • Uniquement les entiers de 4 à 15, bornes incluses
  • Les décimales, chaînes numériques, auto et -1 ne sont pas pris en charge
  • La durée de sortie influe directement sur la facturation
Plage requise: 4 <= x <= 15
Exemple:

4

quality
enum<string>
défaut:768p

Résolution de la vidéo de sortie. Valeur par défaut : 768p.

Valeurs disponibles :

  • 768p : valeur par défaut
  • 2k

Remarques :

  • Sans ce paramètre, la sortie est en 768p ; pour le 2K, transmettez explicitement quality="2k"
  • 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
Options disponibles:
768p,
2k
Exemple:

"768p"

aspect_ratio
enum<string>
défaut:16:9

Format de la vidéo de sortie. Valeur par défaut : 16:9.

Valeurs disponibles :

  • 16:9 : paysage
  • 21:9 : ultra-large
  • 4:3 : paysage standard
  • 1:1 : carré
  • 3:4 : portrait standard
  • 9:16 : portrait
Options disponibles:
16:9,
21:9,
4:3,
1:1,
3:4,
9:16
Exemple:

"16:9"

callback_url
string<uri>

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 2048 caracteres

Mecanisme de rappel :

  • Delai d'expiration : 10 secondes
  • Jusqu'a 3 tentatives apres un echec (respectivement 1/2/4 secondes 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
Pattern: ^https://
Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tache de generation video creee avec succes

created
integer

Horodatage de creation de la tache

Exemple:

1761313744

id
string

ID de la tache

Exemple:

"task-unified-1774857405-abc123"

model
string

Nom du modele effectivement utilise

Exemple:

"minimax-h3-text-to-video"

object
enum<string>

Type specifique de la tache

Options disponibles:
video.generation.task
progress
integer

Pourcentage de progression de la tache (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

status
enum<string>

Statut de la tache

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

task_info
object

Informations detaillees de la tache video

type
enum<string>

Type de sortie de la tache

Options disponibles:
text,
image,
audio,
video
Exemple:

"video"

usage
object

Informations d'utilisation et de facturation