> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Minimax H3 Reference-to-Video > - Jusqu’à 9 images, 3 vidéos et 3 audios de référence - Au moins une image ou vidéo est requise ; audio seul interdit - Durée : `5` à `15` secondes ; seul `2k` est pris en charge - [Consultez la tâche](/fr/api-manual/task-management/get-task-detail) avec son ID - Les URL générées restent valides 24 heures ## OpenAPI ````yaml fr/api-manual/video-series/minimax/minimax-h3/minimax-h3-reference-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: API Minimax H3 Reference-to-Video description: API Minimax H3 référence-vers-vidéo avec références image, vidéo et audio license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Generation video description: Interfaces de generation video par IA paths: /v1/videos/generations: post: tags: - Generation video summary: Minimax H3 Reference-to-Video multimodale description: >- - Jusqu’à 9 images, 3 vidéos et 3 audios de référence - Au moins une image ou vidéo est requise ; audio seul interdit - Durée : `5` à `15` secondes ; seul `2k` est pris en charge - [Consultez la tâche](/fr/api-manual/task-management/get-task-detail) avec son ID - Les URL générées restent valides 24 heures operationId: createMinimaxH3ReferenceToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: image_reference: summary: Référence image value: 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: 5 quality: 2k aspect_ratio: adaptive video_audio_reference: summary: Références vidéo et audio value: model: minimax-h3-reference-to-video prompt: >- Reprendre intégralement le mouvement, le rythme, la composition et le langage de caméra de Video 1. Le personnage dit : « Suis le vent, vis libre. Laisse les soucis derrière toi et profite de l’instant. » Utiliser la voix de Audio 1 et synchroniser les lèvres. video_urls: - >- 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: - >- 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: 5 quality: 2k aspect_ratio: adaptive multimodal: summary: Références multimodales (image + vidéo + audio) value: model: minimax-h3-reference-to-video prompt: >- 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: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: - >- 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: - >- 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: 5 quality: 2k aspect_ratio: adaptive responses: '200': description: Tache de generation video creee avec succes content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Erreur de parametres de requete content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Non authentifie, token invalide ou expire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, rechargement necessaire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Acces non autorise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: >- Token does not have access to model: minimax-h3-reference-to-video type: invalid_request_error '429': description: Limite de frequence de requetes depassee content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: Nom du modele de generation video enum: - minimax-h3-reference-to-video default: minimax-h3-reference-to-video example: minimax-h3-reference-to-video prompt: type: string minLength: 1 description: >- 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 - 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 **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` image de référence ou `1` vidéo de référence ; l’audio de référence ne peut pas être utilisé seul example: >- 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: type: array description: >- 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 `1` image de référence ou `1` vidéo de référence - L’envoi de `audio_urls` seul renvoie une erreur de paramètre default: [] maxItems: 9 items: type: string format: uri example: - >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png video_urls: type: array description: >- 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 `1` image de référence ou `1` vidéo de référence - L’envoi de `audio_urls` seul renvoie une erreur de paramètre default: [] maxItems: 3 items: type: string format: uri example: - >- 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: type: array description: >- 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 **Règles de combinaison :** - L’audio de référence ne peut pas être utilisé seul - Avec `audio_urls`, fournissez aussi au moins `1` image de référence ou `1` vidéo de référence default: [] maxItems: 3 items: type: string format: uri example: - >- 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: type: integer description: >- 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 default: 5 minimum: 5 maximum: 15 example: 5 quality: type: string description: >- 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 enum: - 2k default: 2k example: 2k aspect_ratio: type: string description: >- 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 - `21:9` : ultra-large - `16:9` : paysage - `4:3` : paysage standard - `1:1` : carré - `3:4` : portrait standard - `9:16` : portrait enum: - adaptive - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: adaptive example: adaptive callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/video-task-completed pattern: ^https:// additionalProperties: false VideoGenerationResponse: type: object properties: created: type: integer description: Horodatage de creation de la tache example: 1761313744 id: type: string description: ID de la tache example: task-unified-1774857405-abc123 model: type: string description: Nom du modele effectivement utilise example: minimax-h3-reference-to-video object: type: string enum: - video.generation.task description: Type specifique de la tache progress: type: integer description: Pourcentage de progression de la tache (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tache enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Informations detaillees de la tache video type: type: string enum: - text - image - audio - video description: Type de sortie de la tache example: video usage: $ref: '#/components/schemas/VideoUsage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Indique si la tâche peut être annulée. Minimax H3 ne prend pas en charge l’annulation ; toujours `false`. example: false enum: - false default: false estimated_time: type: integer description: Temps estime d'achevement (secondes) minimum: 0 example: 165 video_duration: type: integer description: Duree de la video (secondes) example: 8 VideoUsage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Regle de facturation enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Nombre de credits estimes consommes minimum: 0 example: 50 user_group: type: string description: Categorie du groupe utilisateur example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les interfaces necessitent une authentification par Bearer Token ## **Obtenir une cle API :** Visitez la [Page de gestion des cles API](https://evolink.ai/dashboard/keys) pour obtenir votre cle API **Ajoutez dans l'en-tete de la requete :** ``` Authorization: Bearer YOUR_API_KEY ``` ````