01content: text
Texte vers vidéo (t2va)
Envoyez un élément texte obligatoire et inventez le plan complet. Pour la génération purement textuelle, le ratio est obligatoire et ne peut pas être adaptatif.
API MiniMax H3MiniMax-H3 · API de génération vidéo · minimaxh3.video
L'API MiniMax H3 pour la génération vidéo en production
Créez des workflows texte-vidéo, avec contrôle des premières et dernières images ou références omnimodales, grâce à l'API MiniMax H3. Une interface asynchrone renvoie d'abord un identifiant de tâche, puis une URL de téléchargement.
POST /api/v1/video_generation200 · task_id
curl --request POST \
--url https://minimaxh3.video/api/v1/video_generation \
--header "Authorization: Bearer $MINIMAX_H3_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Un cycliste traverse une rue urbaine plongée dans la nuit et la pluie, reflets néon sur l'asphalte mouillé, caméra en travelling latéral à vélo."
}
],
"duration": 5,
"resolution": "2K",
"ratio": "16:9"
}'- Point d'accès
- POST /api/v1/video_generation
- ID du modèle
- MiniMax-H3
- Workflow
- Tâche asynchrone
- Sortie
- 2K · 4–15s
- Authentification
- Bearer API key
- Limite du prompt
- 7 000 caractères
Contrat public
Un endpoint MiniMax H3, trois modes créatifs.
MiniMax-H3 utilise un tableau de contenu multimodal. Les rôles que vous y attachez déterminent si la requête est du texte-vidéo, de l'image-vidéo avec contrôle de début/fin, ou de la génération par référence.
02content: text + images
Image de début / de fin (i2va)
Ajoutez des éléments image_url avec le rôle first_frame et éventuellement last_frame pour contrôler la composition d'ouverture et de clôture.
03content: text + refs
Génération par référence (r2va)
Guidez le personnage, le mouvement, la caméra, le style ou la voix avec des références image, vidéo et audio — sans mélanger les rôles de début/fin.
Ce que l'API expose
Contrôlez la scène, les références et le contrat de sortie.
MiniMax H3 est présenté comme un modèle vidéo multimodal ouvert et généraliste. L'interface V2 est conçue pour les backends de production, pas seulement pour des essais ponctuels.
Entrée multimodale
Texte, image, vidéo et audio dans une même requête
Chaque élément de contenu est typé et peut porter un rôle. Les références audio doivent accompagner une entrée image ou vidéo.
Fenêtre de sortie
2K natif pour 4 à 15 secondes
La durée accepte des secondes entières de 4 à 15. Les ratios d'aspect courants sont pris en charge ; l'adaptatif est autorisé quand les médias définissent la géométrie.
Budget de prompt
Jusqu'à 7 000 caractères de direction
Utilisez cet espace pour structurer le plan, le mouvement, le parcours de caméra, l'intention du dialogue et l'association des références, pas pour accumuler des mots-clés.
Sécurité des rôles
Les images de début/fin et les références s'excluent mutuellement
Si un rôle reference_* apparaît, first_frame et last_frame ne doivent pas être présents. Concevez la validation autour de cette règle pour éviter les 400 évitables.
Résultat asynchrone
task_id → status → content.url
Les tâches réussies retournent une URL de téléchargement à durée limitée directement dans la réponse de requête. Persistez les identifiants et stockez le fichier si la durabilité compte.
Hygiène des tâches
Lister, annuler et fenêtres d'expiration
La V2 documente la liste, l'annulation ou la suppression, ainsi qu'une courte fenêtre de consultation des tâches récentes. Gérez la génération comme une tâche en file d'attente, pas comme un long appel HTTP unique.
Adéquation produit
Ce que les équipes construisent avec l'API MiniMax H3
Utilisez le même workflow asynchrone pour des contenus créatifs ponctuels, des outils pour créateurs ou des traitements par lots.
Produits créateurs
Génération de plans in-app
Permettez aux utilisateurs de soumettre un prompt ou une image de début, affichez l'état de file d'attente et livrez un clip 2K quand la tâche réussit.
Systèmes de marque
Campagnes guidées par référence
Maintenez des références de personnage, produit, mouvement ou voix à travers des plans courts sans reconstruire l'identité à chaque fois.
Outils éditoriaux
Transitions début-fin contrôlées
Dirigez une image d'ouverture et de clôture contrôlées quand la continuité du storyboard prime sur l'improvisation pure.
Pipelines sociaux
Ratios vertical et cinématographique
Générez des accroches 9:16 ou des plans maîtres 16:9 depuis une même surface d'intégration, et bifurquez uniquement sur le ratio et la durée.
Backends d'agents
Jobs multimodaux en file d'attente
Les agents peuvent assembler des tableaux de contenu, interroger le statut et transmettre content.url vers stockage, modération ou étapes de montage.
Studios de prototypage
Tests de direction rapides
Explorez les combinaisons de caméra, performance et référence avant de vous engager dans un pipeline de production complet.
Workflow asynchrone
De la clé API à une vidéo MiniMax H3 téléchargeable
La génération ne nécessite jamais de maintenir une requête HTTP ouverte. Stockez les identifiants et progressez à travers les étapes V2 documentées.
Créer
Soumettre une tâche de génération
POST avec model MiniMax-H3, un tableau content, la durée, la résolution et le ratio quand requis. Une réponse réussie retourne task_id.
POST /api/v1/video_generationObserver
Interroger le statut de la tâche
Requêtez la tâche jusqu'à ce qu'elle atteigne un état terminal. Traitez queued et running comme des états intermédiaires sains.
GET /api/v1/video_generation/{task_id}Récupérer
Télécharger content.url
En cas de succès, la réponse inclut content.url. L'URL est à durée limitée — copiez le fichier dans un stockage que vous contrôlez s'il doit rester durable.
content.url · mp4Conception de la requête
Les champs qui façonnent une requête MiniMax-H3 fiable
Gardez la requête publique explicite et validez les combinaisons spécifiques au mode avant de soumettre une tâche.
Obligatoire
model
Utilisez l'identifiant documenté exact MiniMax-H3. N'inventez pas de surnoms de produit comme IDs de modèle.
Corps multimodal obligatoire
content[]
Au moins un élément type=text. Ajoutez des éléments image_url, video_url ou audio_url avec des rôles pour les modes contrôlés.
4–15 secondes entières
duration
Choisissez une fenêtre en secondes entières. Plus long n'est pas toujours meilleur si le plan ne nécessite qu'une action claire.
Sortie documentée
resolution
MiniMax H3 est documenté pour une sortie 2K. Confirmez les valeurs d'énumération actuelles contre la référence API en ligne avant de déployer.
Contrôle de géométrie
ratio
Ce champ est obligatoire pour la génération uniquement à partir de texte et ne peut pas être adaptatif dans ce mode. Les workflows guidés par une image peuvent reprendre le format de la source.
Rôles de média optionnels
first_frame · last_frame · reference_*
Les rôles modifient le comportement créatif. Vérifiez leur exclusion mutuelle et les limites de taille de chaque fichier lors de l'importation.
État de la tâche
Traitez le statut comme une machine à états
Les clients d'interrogation doivent tolérer les états intermédiaires et s'arrêter uniquement sur les résultats terminaux documentés.
| Statut | Signification | Comportement applicatif recommandé |
|---|---|---|
| queued | En attente de capacité | Persistez task_id et espacez les interrogations |
| running | Génération en cours | Gardez la tâche visible et évitez les soumissions en double |
| succeeded | Vidéo prête | Lisez content.url et enregistrez le fichier |
| failed | Génération non terminée | Affichez le code/message d'erreur et permettez une réitération délibérée |
| cancelled | Tâche annulée | Fermez l'interface du job et conservez une piste d'audit |
| expired | Tâche désormais indisponible | N'interrogez pas indéfiniment ; recréez si nécessaire |
Seules les tâches récentes restent interrogeables. Confirmez la fenêtre de rétention officielle avant de concevoir des flux de récupération longue durée.
Limites d'entrée
Validez les médias avant qu'ils n'atteignent MiniMax H3
Les limites documentées sont assez simples pour être appliquées au moment de l'upload, évitant ainsi des échecs de tâche évitables.
Images
JPG, JPEG, PNG, WEBP, HEIC, HEIF · ≤ 30 Mo
Largeur/hauteur dans [256, 5760] ; ratio d'aspect entre 2:5 et 5:2. Image de début ≤ 1, image de fin ≤ 1, images de référence ≤ 9.
Vidéos
MP4/MOV avec H.264/H.265 · ≤ 50 Mo chacune
Jusqu'à 3 clips de référence, chacun 2–15s, total ≤ 15s. L'audio intégré peut être AAC ou MP3.
Audio
WAV ou MP3 · ≤ 15 Mo chacun
Jusqu'à 3 clips, chacun 2–15s, total ≤ 15s. L'audio ne peut pas être envoyé seul — associez-le à des références image ou vidéo.
Réfs mixtes
Au plus 12 fichiers média par requête
Le corps de la requête doit rester ≤ 64 Mo. Pour les fichiers volumineux, préférez les URL publiques au Base64.
Exclusion de mode
Ne mélangez pas images de début/fin et rôles de référence
Choisissez soit le contrôle de composition (début/fin), soit la génération par référence omnidirectionnelle — pas les deux dans un même tableau de contenu.
Prompt
Gardez la direction sous 7 000 caractères
Associez explicitement les références dans le texte quand l'identité, la voix ou le mouvement doivent suivre un fichier précis.
La tarification reste sur la page de prix
Les taux de crédits et les limites de plan peuvent changer. Liez vers la page de prix MiniMax H3 en ligne au lieu de coder en dur un nombre dans votre intégration.
Adéquation de conception
Un bon choix pour la génération MiniMax H3 asynchrone
Choisissez l'API V2 quand votre produit peut créer une tâche et attendre le contenu généré.
Bonne adéquation
Services backend et outils créateurs
La génération en file d'attente, le stockage durable et les interfaces d'état s'intègrent naturellement aux workflows basés sur task_id.
Bonne adéquation
Contrôle créatif multimodal
Plans qui combinent direction par prompt avec images de début, de fin, ou médias de référence.
Limite
Pas un socket vidéo en temps réel
Prévoyez des interrogations périodiques ou des processus internes en file d'attente, plutôt que de maintenir une connexion de génération ouverte.
Limite
Concevez des tâches, pas des connexions ouvertes
Gardez la génération longue dans votre file backend et exposez le statut dans l'interface produit.
Questions API
Questions sur l'API MiniMax H3
Réponses pratiques avant de câbler la première requête de production.
MiniMax-H3 est-il le model ID pour cette API ?
Oui. Envoyez model MiniMax-H3 sur l'endpoint de génération vidéo MiniMax H3 lors de la création d'une tâche.
Quel endpoint dois-je appeler ?
Créez des tâches avec POST https://minimaxh3.video/api/v1/video_generation, puis interrogez avec GET https://minimaxh3.video/api/v1/video_generation/{task_id}. En cas de succès, téléchargez le mp4 depuis content.url.
En quoi MiniMax H3 diffère-t-il de l'intégration Hailuo 2.3 ?
H3 est le modèle multimodal généraliste actuel, avec un contrat content[], une sortie 2K documentée, une durée de 4 à 15 s et des références omnimodales. Hailuo 2.3 reste une famille de modèles antérieure, avec une structure de requête différente.
Puis-je combiner le contrôle d'image de début avec de l'audio de référence ?
Pas dans la même requête. Les rôles first/last-frame et reference_* s'excluent mutuellement. Choisissez le mode qui correspond au contrôle dont vous avez besoin.
Comment m'authentifier ?
Envoyez une clé API Bearer dans l'en-tête Authorization. Créez et gérez les clés depuis les paramètres de votre compte MiniMax H3 après avoir obtenu l'accès.
Où dois-je confirmer les prix actuels ?
Utilisez la page de tarification du site pour les plans produits et les crédits. L'utilisation API suit les mêmes règles de portefeuille de crédits publiées là-bas.
Prototypiez le plan. Déployez la requête API.
Façonnez la direction créative dans le générateur, puis appelez l'API MiniMax H3 sur minimaxh3.video avec votre clé.