curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Bande-annonce épique de space opera : une capitaine se tient seule devant une immense baie d’observation tandis que la dernière flotte se rassemble à l’extérieur. Le saut de la flotte provoque un éclair blanc aveuglant et fait violemment trembler la passerelle ; lorsque la lumière disparaît, elle reste seule dans le silence de l’espace profond. Éclairage cinématographique, lent travelling avant, atmosphère grandiose mais retenue.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax H3

Guide complet des paramètres Minimax H3 / H3 Max / H3 Max Turbo

API unifiée pour toute la gamme Minimax H3, H3 Max et H3 Max Turbo. Sélectionnez le mode de génération avec le paramètre model.

3 modes de génération, 8 modèles :

Mode	ID du modèle	Ressources d’entrée
Text-to-Video	`minimax-h3-text-to-video`	`prompt` uniquement
Text-to-Video	`minimax-h3-max-text-to-video`	`prompt` uniquement
Text-to-Video	`minimax-h3-max-turbo-text-to-video`	`prompt` uniquement
Image-to-Video	`minimax-h3-image-to-video`	`prompt` + `image_start` et/ou `image_end`
Image-to-Video	`minimax-h3-max-image-to-video`	`prompt` + `image_start`, avec `image_end` facultatif
Image-to-Video	`minimax-h3-max-turbo-image-to-video`	`prompt` + `image_start`, avec `image_end` facultatif
Reference-to-Video	`minimax-h3-reference-to-video`	`prompt` + au moins un des champs `image_urls` / `video_urls` / `audio_urls`
Reference-to-Video	`minimax-h3-max-reference-to-video`	`prompt` + au moins un des champs `image_urls` / `video_urls`, avec `audio_urls` facultatif

Différences de paramètres :

Minimax H3 : durée de sortie de 4 à 15 secondes ; résolution 768p (par défaut) ou 2k; la génération image-vers-vidéo accepte la dernière image seule et la génération référence-vers-vidéo accepte l’audio seul
Minimax H3 Max : durée de sortie de 5 à 15 secondes ; résolution 480p ou 768p (par défaut); la génération image-vers-vidéo exige une première image et la génération référence-vers-vidéo exige une image ou une vidéo de référence
Minimax H3 Max Turbo : mêmes durées et résolutions de sortie que H3 Max ; prend en charge le texte-vers-vidéo et l’image-vers-vidéo avec première image ou première et dernière image, mais pas la référence multimodale

Différences de facturation des ressources de référence :

H3 référence-vers-vidéo : les 5 premières images de référence sont gratuites ; la durée d’entrée des vidéos de référence et la durée de sortie sont facturées au même tarif
H3 Max référence-vers-vidéo : les 2 premières images de référence sont gratuites, puis chaque image est facturée à partir de la 3e ; les durées des vidéos d’entrée et de sortie sont facturées à leurs tarifs respectifs
L’audio de référence est gratuit pour les deux modèles référence-vers-vidéo

Capacités communes :

Traitement asynchrone ; utilisez l’ID de tâche renvoyé pour consulter la tâche
Les tâches Minimax H3, H3 Max et H3 Max Turbo ne peuvent pas être annulées
Les URL des vidéos générées restent valides pendant 24 heures ; enregistrez rapidement le résultat

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Bande-annonce épique de space opera : une capitaine se tient seule devant une immense baie d’observation tandis que la dernière flotte se rassemble à l’extérieur. Le saut de la flotte provoque un éclair blanc aveuglant et fait violemment trembler la passerelle ; lorsque la lumière disparaît, elle reste seule dans le silence de l’espace profond. Éclairage cinématographique, lent travelling avant, atmosphère grandiose mais retenue.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

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 :

Authorization: Bearer YOUR_API_KEY

Corps

application/json

model

enum<string>

requis

Nom du modèle de génération vidéo.

ID du modèle	Mode	Paramètres multimédias
`minimax-h3-text-to-video`	Texte vers vidéo	N’accepte aucune ressource multimédia
`minimax-h3-max-text-to-video`	Texte vers vidéo	N’accepte aucune ressource multimédia
`minimax-h3-max-turbo-text-to-video`	Texte vers vidéo	N’accepte aucune ressource multimédia
`minimax-h3-image-to-video`	Image vers vidéo	`image_start` et/ou `image_end`
`minimax-h3-max-image-to-video`	Image vers vidéo	`image_start`, avec `image_end` facultatif
`minimax-h3-max-turbo-image-to-video`	Image vers vidéo	`image_start`, avec `image_end` facultatif
`minimax-h3-reference-to-video`	Référence multimodale vers vidéo	au moins un des champs `image_urls` / `video_urls` / `audio_urls`
`minimax-h3-max-reference-to-video`	Référence multimodale vers vidéo	au moins un des champs `image_urls` / `video_urls`, avec `audio_urls` facultatif

Options disponibles:

minimax-h3-text-to-video,

minimax-h3-max-text-to-video,

minimax-h3-max-turbo-text-to-video,

minimax-h3-image-to-video,

minimax-h3-max-image-to-video,

minimax-h3-max-turbo-image-to-video,

minimax-h3-reference-to-video,

minimax-h3-max-reference-to-video

Exemple:

"minimax-h3-text-to-video"

prompt

string

requis

Décrivez la vidéo à générer. Ce champ est obligatoire et ne peut pas être vide.

Exigences du prompt :

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

Utilisation selon le modèle :

Text-to-Video : Décrivez la scène, le sujet, l’action, la caméra et l’ambiance ; n’envoyez aucun champ multimédia
Image-to-Video : Décrivez le mouvement des sujets dans les images clés et celui de la caméra. H3 accepte image_start et/ou image_end ; H3 Max et H3 Max Turbo exigent image_start, avec image_end facultatif
Reference-to-Video : Décrivez l’utilisation des ressources de référence. Désignez-les par Image 1, Image 2, Video 1, Audio 1, etc. ; n’utilisez pas la notation Seedance telle que @image1 ou @video1. La numérotation commence à 1 et suit l’ordre de chaque tableau d’URL

Required string length: 1 - 7000

Exemple:

"Scène cinématographique : un astronaute se tient devant la baie d’observation d’une base lunaire tandis que la caméra avance lentement et que la Terre se lève au-dessus de l’horizon."

image_start

string<uri>

Modèles applicables :

minimax-h3-image-to-video
minimax-h3-max-image-to-video
minimax-h3-max-turbo-image-to-video
Les modèles texte-vers-vidéo et référence-vers-vidéo ne prennent pas ce paramètre en charge

URL HTTP(S) de l’image de début.

Règles de combinaison :

H3: Fournissez au moins l’un des champs image_start et image_end
H3 Max / H3 Max Turbo: image_start est obligatoire ; image_end ne peut pas être fourni seul
image_start uniquement : génération à partir de la première image
Les deux champs : génération entre une première et une dernière image
Au maximum 1 première image ; ce champ accepte une seule URL

Exigences de l’image :

Formats : JPG, JPEG, PNG, WEBP, HEIC, HEIF
Taille : 30MB maximum
Largeur et hauteur : de 256 à 5760 px chacune
Rapport largeur/hauteur : 0.4–2.5
L’URL doit utiliser HTTP(S) et être directement accessible par le service
Le corps JSON complet ne doit pas dépasser 64MB ; les entrées Base64 et mm_file:// ne sont pas acceptées

Exemple:

"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"

image_end

string<uri>

Modèles applicables :

minimax-h3-image-to-video
minimax-h3-max-image-to-video
minimax-h3-max-turbo-image-to-video
Les modèles texte-vers-vidéo et référence-vers-vidéo ne prennent pas ce paramètre en charge

URL HTTP(S) de l’image de fin.

Règles de combinaison :

H3: Fournissez au moins l’un des champs image_end et image_start
H3 Max / H3 Max Turbo: image_start est obligatoire ; image_end ne peut pas être fourni seul
H3: image_end uniquement : le modèle génère un mouvement naturel qui se termine sur cette image
Les deux champs : génération entre une première et une dernière image
Au maximum 1 dernière image ; ce champ accepte une seule URL

Exigences de l’image :

Formats : JPG, JPEG, PNG, WEBP, HEIC, HEIF
Taille : 30MB maximum
Largeur et hauteur : de 256 à 5760 px chacune
Rapport largeur/hauteur : 0.4–2.5
L’URL doit utiliser HTTP(S) et être directement accessible par le service
Le corps JSON complet ne doit pas dépasser 64MB ; les entrées Base64 et mm_file:// ne sont pas acceptées

Exemple:

"https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85"

image_urls

string<uri>[]

Modèles applicables :

minimax-h3-reference-to-video
minimax-h3-max-reference-to-video
H3 Max Turbo ne prend pas en charge les ressources de référence multimodales
Les modèles texte-vers-vidéo et image-vers-vidéo ne prennent pas ce paramètre en charge

Tableau d’URL HTTP(S) d’images de référence. Valeur par défaut [] ; maximum 9 images.

Rôle et numérotation :

Toutes les images sont utilisées comme reference_image
Le premier élément est Image 1, le deuxième Image 2, etc.

Exigences des images :

Formats : JPG, JPEG, PNG, WEBP, HEIC, HEIF
Taille : 30MB maximum par image
Largeur et hauteur : de 256 à 5760 px chacune
Rapport largeur/hauteur : 0.4–2.5
Les URL doivent utiliser HTTP(S) et être directement accessibles par le service
Le corps JSON complet ne doit pas dépasser 64MB ; les entrées Base64 et mm_file:// ne sont pas acceptées

Facturation :

H3: Les 5 premières images de référence sont gratuites ; chaque image est facturée à partir de la 6e
H3 Max: Les 2 premières images de référence sont gratuites ; chaque image est facturée à partir de la 3e

Règles de combinaison :

H3: Fournissez au moins l’un des paramètres image_urls, video_urls ou audio_urls
H3 Max: Au moins l’un des champs image_urls ou video_urls doit contenir une ressource ; audio_urls seul n’est pas pris en charge
Le total des trois types de références ne doit pas dépasser 12 éléments (images + vidéos + audios de référence)
Si les trois sont vides, une erreur de paramètre est renvoyée ; pour une génération à partir de texte seul, utilisez minimax-h3-text-to-video, minimax-h3-max-text-to-video ou minimax-h3-max-turbo-text-to-video

Maximum array length: 9

Exemple:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
]

video_urls

string<uri>[]

Modèles applicables :

minimax-h3-reference-to-video
minimax-h3-max-reference-to-video
H3 Max Turbo ne prend pas en charge les ressources de référence multimodales
Les modèles texte-vers-vidéo et image-vers-vidéo ne prennent pas ce paramètre en charge

Tableau d’URL HTTP(S) de vidéos de référence. Valeur par défaut [] ; maximum 3 vidéos.

Rôle et numérotation :

Toutes les vidéos sont utilisées comme reference_video
Le premier élément est Video 1, le deuxième Video 2, etc.

Exigences des vidéos :

Conteneurs : MP4 (.mp4), MOV (.mov)
Codecs vidéo : H.264/AVC, H.265/HEVC
Codecs audio intégrés : AAC, MP3
Taille : 50MB maximum par vidéo
Durée : 2–15 secondes par clip ; durée totale des vidéos de référence limitée à 15 secondes
Largeur et hauteur : de 256 à 5760 px chacune
Rapport largeur/hauteur : 0.4–2.5
Fréquence d’images : 23.976–60 FPS
Les URL doivent utiliser HTTP(S) et être directement accessibles par le service
Le corps JSON complet ne doit pas dépasser 64MB ; les entrées Base64 et mm_file:// ne sont pas acceptées

Facturation :

H3: La durée d’entrée des vidéos de référence et la durée de sortie sont facturées au même tarif
H3 Max: La durée d’entrée des vidéos de référence est facturée à un tarif distinct de celui des vidéos de sortie
H3 Max: Additionnez d’abord les durées de toutes les vidéos de référence, puis arrondissez à la seconde supérieure ; ne regroupez pas les secondes d’entrée et de sortie à un tarif unique

Règles de combinaison :

H3: Fournissez au moins l’un des paramètres image_urls, video_urls ou audio_urls
H3 Max: Au moins l’un des champs image_urls ou video_urls doit contenir une ressource ; audio_urls seul n’est pas pris en charge
Le total des trois types de références ne doit pas dépasser 12 éléments (images + vidéos + audios de référence)
Si les trois sont vides, une erreur de paramètre est renvoyée ; pour une génération à partir de texte seul, utilisez minimax-h3-text-to-video, minimax-h3-max-text-to-video ou minimax-h3-max-turbo-text-to-video

Maximum array length: 3

Exemple:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4"
]

audio_urls

string<uri>[]

Modèles applicables :

minimax-h3-reference-to-video
minimax-h3-max-reference-to-video
H3 Max Turbo ne prend pas en charge les ressources de référence multimodales
Les modèles texte-vers-vidéo et image-vers-vidéo ne prennent pas ce paramètre en charge

Tableau d’URL HTTP(S) d’audios de référence. Valeur par défaut [] ; maximum 3 clips.

Rôle et numérotation :

Tous les clips audio sont utilisés comme reference_audio
Le premier élément est Audio 1, le deuxième Audio 2, etc.

Exigences audio :

Formats : WAV, MP3
Taille : 15MB maximum par clip
Durée : 2–15 secondes par clip ; durée totale des audios de référence limitée à 15 secondes
Les URL doivent utiliser HTTP(S) et être directement accessibles par le service
Le corps JSON complet ne doit pas dépasser 64MB ; les entrées Base64 et mm_file:// ne sont pas acceptées

Facturation :

L’audio de référence est gratuit et n’entre pas dans la durée facturable des vidéos de référence

Règles de combinaison :

H3: audio_urls peut être utilisé seul ; aucune image ni vidéo de référence n’est nécessaire
H3 Max: L’audio de référence doit être accompagné de image_urls ou video_urls ; pour une référence audio seule, utilisez minimax-h3-reference-to-video
Le total des trois types de références ne doit pas dépasser 12 éléments (images + vidéos + audios de référence)
Si les trois sont vides, une erreur de paramètre est renvoyée ; pour une génération à partir de texte seul, utilisez minimax-h3-text-to-video, minimax-h3-max-text-to-video ou minimax-h3-max-turbo-text-to-video

Maximum array length: 3

Exemple:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3"
]

duration

integer

Durée de la vidéo de sortie en secondes. La plage de valeurs et la valeur par défaut dépendent de model.

Modèles applicables :

Les 8 modèles Minimax H3, H3 Max et H3 Max Turbo

Restrictions par modèle :

Minimax H3 : entiers de 4 à 15, bornes incluses ; valeur par défaut 4 secondes
Minimax H3 Max / H3 Max Turbo : entiers de 5 à 15, bornes incluses ; valeur par défaut 5 secondes
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:

5

quality

enum<string>

défaut:768p

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

Modèles applicables :

Les 8 modèles Minimax H3, H3 Max et H3 Max Turbo

Valeurs disponibles par modèle :

Minimax H3 : 768p (par défaut), 2k
Minimax H3 Max / H3 Max Turbo : 480p, 768p (par défaut)

Remarques :

Sans ce paramètre, la sortie est en 768p
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:

480p,

768p,

2k

Exemple:

"768p"

aspect_ratio

enum<string>

Format d’image de la vidéo de sortie.

Modèles applicables et valeurs par défaut :

minimax-h3-text-to-video, minimax-h3-max-text-to-video, minimax-h3-max-turbo-text-to-video : formats explicites uniquement ; valeur par défaut 16:9
minimax-h3-reference-to-video, minimax-h3-max-reference-to-video : prend en charge toutes les options ci-dessous ; valeur par défaut adaptive
minimax-h3-image-to-video, minimax-h3-max-image-to-video, minimax-h3-max-turbo-image-to-video : le modèle adapte automatiquement le format de la vidéo de sortie à l’image d’entrée ; n’envoyez pas ce paramètre dans les requêtes image-vers-vidéo

Valeurs disponibles :

adaptive : uniquement pour la génération référence-vers-vidéo ; le modèle choisit un format adapté aux ressources de référence et au prompt
16:9 : paysage
21:9 : ultra-large
4:3 : paysage standard
1:1 : carré
3:4 : portrait standard
9:16 : portrait

Options disponibles:

adaptive,

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

Modèles applicables :

Les 8 modèles Minimax H3, H3 Max et H3 Max Turbo

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

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

Show child attributes

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

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Guide complet des paramètres Minimax H3 / H3 Max / H3 Max Turbo

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse