curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-max-image-to-video",
  "prompt": "Faire passer progressivement la mise au point du bol de ramen au premier plan vers les personnes à l’arrière-plan. Davantage de vapeur s’élève naturellement pendant que la caméra avance légèrement ; conserver l’identité des personnages et le décor du restaurant.",
  "image_start": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png",
  "duration": 5,
  "quality": "768p"
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "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-max-image-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"
  }
}

H3 Max

Minimax H3 Max Image-to-Video

image_start est obligatoire ; la première image seule ou la première et la dernière image sont prises en charge, mais pas la dernière image seule
Durée : 5 à 15 secondes ; résolution 480p ou 768p (par défaut)
Le modèle adapte automatiquement le format de la vidéo de sortie à l’image d’entrée ; aspect_ratio n’est pas nécessaire
Consultez la tâche avec son ID
Les URL générées restent valides 24 heures

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-max-image-to-video",
  "prompt": "Faire passer progressivement la mise au point du bol de ramen au premier plan vers les personnes à l’arrière-plan. Davantage de vapeur s’élève naturellement pendant que la caméra avance légèrement ; conserver l’identité des personnages et le décor du restaurant.",
  "image_start": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png",
  "duration": 5,
  "quality": "768p"
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "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-max-image-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-max-image-to-video

requis

Nom du modele de generation video

Options disponibles:

minimax-h3-max-image-to-video

Exemple:

"minimax-h3-max-image-to-video"

prompt

string

requis

Décrivez le mouvement de l’image d’entrée, les changements de caméra et le contenu vidéo souhaité.

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 :

Utilisez image_start pour la première image et éventuellement image_end pour la dernière ; la dernière image seule n’est pas prise en charge
video_urls et audio_urls ne sont pas pris en charge ; leur envoi renvoie une erreur de paramètre

Required string length: 1 - 7000

Exemple:

"Faire passer progressivement la mise au point du bol de ramen au premier plan vers les personnes à l’arrière-plan. Davantage de vapeur s’élève naturellement pendant que la caméra avance légèrement ; conserver l’identité des personnages et le décor du restaurant."

image_start

string<uri>

requis

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

Règles de combinaison :

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

Minimum string length: 1

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>

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

Règles de combinaison :

image_end est facultatif et doit être fourni avec image_start
image_end seul n’est pas pris en charge ; utilisez minimax-h3-image-to-video pour générer à partir de la dernière image seule
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"

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:768p

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

Valeurs disponibles :

480p
768p : valeur 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

Exemple:

"768p"

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-max-image-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 Max Image-to-Video

Autorisations

Toutes les interfaces necessitent une authentification par Bearer Token

Corps

Réponse