Minimax H3 Reference-to-Video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-reference-to-video",
  "prompt": "Utiliser la personne de Image 1 comme unique référence du personnage, en conservant son visage, sa coiffure et ses vêtements. Le personnage marche face au vent sur une promenade en bord de mer ; la caméra le suit avec fluidité d’un plan moyen à un gros plan latéral, en contre-jour au coucher du soleil.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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"
  }
}

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-reference-to-video",
  "prompt": "Utiliser la personne de Image 1 comme unique référence du personnage, en conservant son visage, sa coiffure et ses vêtements. Le personnage marche face au vent sur une promenade en bord de mer ; la caméra le suit avec fluidité d’un plan moyen à un gros plan latéral, en contre-jour au coucher du soleil.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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>

défaut:minimax-h3-reference-to-video

requis

Nom du modele de generation video

Options disponibles:

minimax-h3-reference-to-video

Exemple:

"minimax-h3-reference-to-video"

prompt

string

requis

Décrivez comment utiliser les médias de référence et 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

Référencement des médias :

Utilisez Image 1, Image 2, Video 1, Audio 1, etc. ; n’utilisez pas les balises Seedance @image1 ou @video1
La numérotation commence à 1 et suit l’ordre de chaque tableau d’URL
Le premier élément de image_urls est Image 1, le premier de video_urls est Video 1 et le premier de audio_urls est Audio 1

Restrictions d’entrée :

image_start et image_end ne sont pas pris en charge
Fournissez au moins 1 élément de référence : image, vidéo ou audio ; l’audio de référence peut être utilisé seul

Required string length: 1 - 7000

Exemple:

"Remplacer la personne de Video 1 par le personnage de Image 1, en conservant son visage, sa coiffure et ses vêtements. Garder le mouvement, le rythme, la composition et la caméra de Video 1, puis interpréter le dialogue avec la voix de Audio 1 en synchronisant les lèvres."

image_urls

string<uri>[]

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

Règles de combinaison :

Fournissez au moins l’un des paramètres image_urls, video_urls ou audio_urls
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 ; utilisez minimax-h3-text-to-video pour une génération à partir de texte seul

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>[]

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 :

La durée d’entrée des vidéos de référence est facturée

Règles de combinaison :

Fournissez au moins l’un des paramètres image_urls, video_urls ou audio_urls
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 ; utilisez minimax-h3-text-to-video pour une génération à partir de texte seul

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>[]

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 :

La durée des audios de référence n’est pas facturée

Règles de combinaison :

audio_urls peut être utilisé seul ; aucune image ni vidéo de référence n’est nécessaire
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 ; utilisez minimax-h3-text-to-video pour une génération à partir de texte seul

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

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:adaptive

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

Valeurs disponibles :

adaptive : le modèle choisit un format adapté aux médias 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:

"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

string

ID de la tache

Exemple:

"task-unified-1774857405-abc123"

model

string

Nom du modele effectivement utilise

Exemple:

"minimax-h3-reference-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

Minimax H3 Reference-to-Video

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse