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
  • Il est recommandé de ne pas dépasser 500 caractères chinois ou 1000 mots 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_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
Minimum string length: 1
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:5

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, auto et -1 ne sont pas pris en charge
  • La durée de sortie influe directement sur la facturation
Plage requise: 5 <= x <= 15
Exemple:

5

quality
enum<string>
défaut:2k

Résolution de la vidéo de sortie. Valeur par défaut : 2k.

Valeur disponible :

  • 2k : seule résolution actuellement prise en charge

Remarques :

  • 768p n’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
Options disponibles:
2k
Exemple:

"2k"

aspect_ratio
enum<string>
défaut:adaptive

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

Valeurs disponibles :

  • adaptive : le modèle choisit un format adapté au prompt
  • 21:9 : ultra-large
  • 16:9 : paysage
  • 4:3 : paysage standard
  • 1:1 : carré
  • 3:4 : portrait standard
  • 9:16 : portrait
Options disponibles:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Exemple:

"adaptive"

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