> ## 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. # Guide complet des paramètres Minimax H3 > API unifiée pour toute la gamme Minimax H3. Sélectionnez le mode de génération avec le paramètre `model`. **3 modes de génération :** | Mode | ID du modèle | Ressources d’entrée | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | `prompt` uniquement | | Image-to-Video | `minimax-h3-image-to-video` | `prompt` + `image_start` et/ou `image_end` | | Reference-to-Video | `minimax-h3-reference-to-video` | `prompt` + `image_urls` / `video_urls` / `audio_urls` | **Capacités communes :** - Durée de sortie de `5` à `15` secondes ; seule la qualité `2k` est actuellement prise en charge - Traitement asynchrone ; utilisez l’ID de tâche renvoyé pour [consulter la tâche](/fr/api-manual/task-management/get-task-detail) - Les tâches Minimax H3 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 ## OpenAPI ````yaml fr/api-manual/video-series/minimax/minimax-h3/minimax-h3-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: API Minimax H3 pour tous les modèles description: >- API unifiée pour les 3 modèles Minimax H3, couvrant la génération texte-vers-vidéo, image-vers-vidéo et référence multimodale-vers-vidéo 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: Génération vidéo Minimax H3 (tous les modèles) description: >- API unifiée pour toute la gamme Minimax H3. Sélectionnez le mode de génération avec le paramètre `model`. **3 modes de génération :** | Mode | ID du modèle | Ressources d’entrée | |:---|:---|:---| | Text-to-Video | `minimax-h3-text-to-video` | `prompt` uniquement | | Image-to-Video | `minimax-h3-image-to-video` | `prompt` + `image_start` et/ou `image_end` | | Reference-to-Video | `minimax-h3-reference-to-video` | `prompt` + `image_urls` / `video_urls` / `audio_urls` | **Capacités communes :** - Durée de sortie de `5` à `15` secondes ; seule la qualité `2k` est actuellement prise en charge - Traitement asynchrone ; utilisez l’ID de tâche renvoyé pour [consulter la tâche](/fr/api-manual/task-management/get-task-detail) - Les tâches Minimax H3 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 operationId: createMinimaxH3VideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: Texte vers vidéo value: 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: 5 quality: 2k aspect_ratio: '16:9' image_to_video: summary: Image vers vidéo (pilotée par la première image) value: model: minimax-h3-image-to-video prompt: >- Déplacer lentement la mise au point du bol de ramen au premier plan vers la personne à l’arrière-plan. La vapeur continue de s’élever du bol et se disperse naturellement dans l’air. Effectuer un léger travelling avant tout en préservant l’identité de la personne et l’environnement 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: 2k reference_to_video: summary: Référence multimodale (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 le visage, la coiffure et les vêtements de Image 1. Préserver intégralement les mouvements, le rythme, la composition et les mouvements de caméra de Video 1, puis interpréter le dialogue avec la voix de Audio 1 en assurant la synchronisation labiale. 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-text-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 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-image-to-video` | Image vers vidéo | `image_start` et/ou `image_end` | | `minimax-h3-reference-to-video` | Référence multimodale vers vidéo | `image_urls` / `video_urls` / `audio_urls` | enum: - minimax-h3-text-to-video - minimax-h3-image-to-video - minimax-h3-reference-to-video example: minimax-h3-text-to-video prompt: type: string minLength: 1 description: >- 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 - 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 **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 la première/dernière image ainsi que l’évolution de la caméra ; utilisez `image_start` et/ou `image_end` - **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 example: >- 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: type: string format: uri description: >- **Modèles applicables :** - Uniquement `minimax-h3-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 :** - Fournissez au moins l’un des champs `image_start` et `image_end` - `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 example: >- https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png image_end: type: string format: uri description: >- **Modèles applicables :** - Uniquement `minimax-h3-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 :** - Fournissez au moins l’un des champs `image_end` et `image_start` - `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 example: >- https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85 image_urls: type: array description: >- **Modèles applicables :** - Uniquement `minimax-h3-reference-to-video` - 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 **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: >- **Modèles applicables :** - Uniquement `minimax-h3-reference-to-video` - 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 :** - 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: >- **Modèles applicables :** - Uniquement `minimax-h3-reference-to-video` - 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 **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 **Modèles applicables :** - Les 3 modèles Minimax H3 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 **Modèles applicables :** - Les 3 modèles Minimax H3 enum: - 2k default: 2k example: 2k aspect_ratio: type: string description: >- Format d’image de la vidéo de sortie. La valeur par défaut est `adaptive`. **Modèles applicables :** - Pris en charge par `minimax-h3-text-to-video` - Pris en charge par `minimax-h3-reference-to-video` - **Non pris en charge par `minimax-h3-image-to-video` ; n’envoyez pas ce paramètre dans les requêtes image-vers-vidéo** **Valeurs disponibles :** - `adaptive` : le modèle choisit un format adapté à partir du prompt ou des ressources de référence - `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 **Modèles applicables :** - Les 3 modèles Minimax H3 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-text-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 ``` ````