MiniMax
MiniMax H3 Max Turbo
minimax-h3-max-turbo/text-to-video
Modèle vidéo MiniMax optimisé pour la vitesse, prenant en charge la génération de vidéos à partir de texte et à partir d'images (première image et dernière image facultative), générant en une seule fois des clips de 1 à 15 secondes en 480P à 1080P, adapté à la production rapide de courtes vidéos marketing et au prévisualisation de storyboards
Essayer minimax-h3-max-turbo/text-to-video
Entrée
Créations
Voir toutes les créationsSortie
videoTarifs
minimax-h3-max-turbo/text-to-video per second
| Spécifications | Prix unitaire |
|---|---|
| 480P | $0.025 |
| 768P | $0.040 |
| 1080P | $0.080 |
Présentation
Il s'agit d'un modèle de génération de vidéo à partir de texte, qui reçoit une description textuelle et génère directement un clip vidéo. Il peut générer des séquences de 1 à 15 secondes, avec trois niveaux de résolution au choix : 480P, 768P et 1080P, et prend en charge six formats d'image : 21:9, 16:9, 4:3, 1:1, 3:4 et 9:16. Le prompt peut contenir jusqu'à 50 000 caractères, et une graine aléatoire peut être spécifiée pour reproduire un résultat. Il convient à la production rapide et en série de vidéos courtes marketing, au prévisualisation de storyboards, à la création de contenus pour les réseaux sociaux et à tout autre scénario nécessitant de générer des images animées à partir de zéro.
Points clés
- Vidéo générée directement à partir de texte, jusqu'à 15 secondes — la durée peut être définie entre 1 et 15 secondes ; la vidéo finale peut dépasser d'environ 0,7 seconde la durée demandée, ce qui convient pour produire un clip court autonome.
- Trois résolutions et six formats d'image — 480P, 768P et 1080P au choix selon les besoins ; six ratios, paysage et portrait, couvrent les principaux scénarios de publication.
- Intensité d'extension du prompt réglable — disabled saute la réécriture, balanced répond en environ une seconde, quality prend jusqu'à environ 30 secondes pour produire un prompt plus riche.
Capacités
Génération de vidéo à partir de texte : il suffit de saisir un prompt textuel pour produire un clip vidéo ; le prompt peut contenir jusqu'à 50 000 caractères, ce qui convient aux scénarios sans matériel existant où l'image doit être construite de zéro.
Durée et résolution au choix : chaque requête sélectionne une durée entre 1 et 15 secondes et une résolution parmi 480P, 768P et 1080P, afin d'équilibrer les détails et les spécifications selon l'usage.
Six ratios d'image : la sortie peut être en 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16, pour s'adapter à la lecture en paysage, aux flux carrés et aux vidéos courtes en portrait, selon les différents formats.
Contrôle de la graine et de l'extension du prompt : une graine aléatoire peut être spécifiée pour fixer le point de départ de la génération ; l'extension du prompt propose trois modes — désactivé, équilibré et haute qualité — pour arbitrer selon le rythme de génération.
Cas d'usage
- Production rapide de plusieurs versions de vidéos courtes par les équipes marketing — saisir une description textuelle des arguments produit ou du thème de la campagne et générer en série plusieurs clips candidats, pour comparer les matériaux avant diffusion sur les réseaux sociaux.
- Création de contenus verticaux par les créateurs sociaux — décrire le contenu visuel en format 9:16 et en durée courte pour obtenir des clips directement publiables sur les plateformes de vidéos courtes.
- Prévisualisation dynamique de storyboards en préproduction audiovisuelle — générer des esquisses animées à partir du texte du scénario de storyboard, pour aider le réalisateur et la direction artistique à valider le rythme des plans et la composition avant la production finale.
- Validation de concepts créatifs publicitaires — décrire succinctement un concept créatif et produire rapidement une vidéo de courte durée, pour présenter une direction animée au client plutôt qu'un film final.
Limites et conseils de sélection
La durée va de 1 à 15 secondes ; la vidéo finale peut dépasser d'environ 0,7 seconde la durée demandée ; le 1080P correspond à un raffinement latent à partir d'une source native en 768P, et non à une génération native. Le prompt peut contenir jusqu'à 50 000 caractères. Le modèle ne prend en charge que la génération de vidéo à partir de texte ; il ne permet pas de conserver la cohérence des personnages et du style à l'aide d'images, de clips ou d'audios de référence, et ne dispose pas de capacités de montage vidéo.
Nouveautés
Voir le journal des modifications →- Nouveau modèle MiniMax H3 Max Turbo est disponible : génération de vidéo à partir de texte et génération de vidéo à partir d'images de début et de fin
Questions fréquentes
Voir toutes les questions →-
Le 1080P de ce modèle est-il généré nativement ?
Ce n'est pas une génération native : le 1080P est obtenu par un raffinement dans l'espace latent à partir d'une source en 768P ; le niveau le plus élevé généré nativement par le modèle est 768P. Si vous avez des exigences strictes sur les détails de l'image, il est recommandé d'évaluer sur la base d'une génération native en 768P, ou de passer à un niveau prenant en charge un master 2K.
-
La génération de vidéo à partir d'une image permet-elle d'utiliser une image de référence pour verrouiller le personnage ?
La génération de vidéo à partir d'une image ne prend actuellement pas en charge les images de référence. image_url sert uniquement d'image de départ : le canevas de génération suit cette image, et il n'est pas possible d'utiliser une image de référence, un extrait de référence ou un fichier audio pour verrouiller le personnage et le style. Pour les scénarios nécessitant une cohérence du personnage, il convient d'utiliser un niveau prenant en charge les images de référence pour la génération de vidéo.
-
Comment configurer les première et dernière images pour contrôler le point d'arrivée du mouvement de caméra ?
Utilisez image_url pour spécifier la première image et end_image_url (facultatif) pour spécifier la dernière image ; le modèle interpolera le mouvement entre les deux. La première image détermine l'ensemble du canevas de sortie, donc la composition et le ratio de la dernière image doivent être proches de ceux de la première, sinon l'interpolation risque de produire des déformations.
-
La durée d'une vidéo générée peut-elle dépasser 15 secondes ?
Une génération unique dure au maximum 15 secondes ; il est impossible de produire un clip plus long en une seule fois. La sortie réelle peut être environ 0,7 seconde plus longue que la duration indiquée. Pour obtenir une vidéo plus longue, générez-la par segments de plan, puis assemblez-les.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : minimax-h3-max-turbo/text-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour minimax-h3-max-turbo/text-to-video et la route default — voir le tableau des paramètres ci-dessous.
seedintegerOptionnelGraine aléatoire servant à contrôler le caractère aléatoire des résultats générés ; si elle est omise, le système choisit automatiquement une graine au hasard.
promptstringRequisminLength 1maxLength 50000Prompt textuel utilisé pour la génération de la vidéo, décrivant le contenu visuel souhaité.
durationnumberOptionnelDéfaut: 5min 1max 15Durée de la vidéo (en secondes), réglable de 1 à 15 secondes, 5 secondes par défaut ; la sortie réelle peut dépasser d'environ 0,7 seconde la valeur demandée. Lorsque target_audio_url est utilisé, la durée doit être d'au moins 2 secondes.
resolutionstringOptionnelDéfaut: "768P"Résolution de génération, au choix 480P, 768P ou 1080P, 768P par défaut ; le 1080P correspond à un raffinement dans l'espace latent à partir de la source native 768P, et non à une génération native.
480P768P1080Paspect_ratiostringOptionnelDéfaut: "16:9"Rapport d'aspect de la vidéo générée, au choix 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 16:9 par défaut.
21:916:94:31:13:49:16target_audio_urlstringOptionnelFacultatif : fournit une URL audio d'au moins 2 secondes et de 15 Mo maximum, servant à fixer la piste audio de la vidéo générée.
prompt_expansion_modestringOptionnelDéfaut: "balanced"Intensité de la réécriture du prompt avant la génération, balanced par défaut. disabled ignore l'extension du prompt ; balanced renvoie en environ 1 seconde ; quality peut prendre jusqu'à environ 30 secondes pour générer un prompt plus riche.
disabledbalancedqualitycallbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-max-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-h3-max-turbo/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-h3-max-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →Modèles associés
Voir tous les modèles →Même type
-
HappyHorse 1.0 Alibaba $0.168 /seconde -
LTX 2.5 Fast Lightricks $0.086 /seconde -
PixVerse V6 PixVerse $0.036 /seconde -
Seedance 2.5 ByteDance $0.121 /seconde -
P-Video 2 Pro Avatar Pruna AI $0.029 /seconde -
Muse Video 1.0 Meta $0.034 /vidéo -
Kling 3.0 Kuaishou $0.100 /seconde -
Runway Gen 4.5 Runway $0.172 /seconde -
PixVerse V6 Max PixVerse $0.030 /seconde -
OmniHuman 2.0 ByteDance $0.100 /seconde -
Ray 3.2 Luma $0.214 /vidéo -
MiniMax H3 Max Turbo MiniMax $0.025 /seconde