Introduction
MiniMax H3 Max Texte vers vidéo transforme un prompt écrit en un clip de 5 à 15 secondes entières en 480p ou 768p, avec ambiance, bruitages et musique générés dans la même passe. MiniMax présente H3 Max comme la variante de H3 axée sur la génération rapide. Deux valeurs par défaut comptent avant la première génération : le format d’image est 1:1 et la durée 8 secondes. Définissez les deux explicitement si vous visez un format de livraison précis.
Choisir le mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| une image d’ouverture validée | MiniMax H3 Max Image vers vidéo |
| une scène écrite ou un script | MiniMax H3 Max Texte vers vidéo |
Fonctionnalités et points forts
Six formats, carré par défaut
aspect_ratio accepte 21:9, 16:9, 4:3, 1:1, 3:4 et 9:16, avec 1:1 par défaut : un brief pensé en écran large envoyé sans ce champ revient carré. L’exemple snow-train-window-hands est construit pour le 21:9 : un train qui traverse toute la largeur du cadre pendant que deux mains se rejoignent de part et d’autre de la vitre du wagon, une composition qui ne survit pas à un recadrage plus carré.
480p pour les essais, 768p pour la prise retenue
resolution accepte 480p ou 768p, 768p par défaut. Il n’existe pas d’option 720p, 1080p ou 4K, et le schéma rejette ces valeurs avant que la requête n’entre en file d’attente. Le 480p coûte moins cher à la seconde : utilisez-le pour essayer le texte, la durée et le cadrage, puis rendez la prise retenue en 768p.
L’expansion du prompt est optionnelle
enable_prompt_expansion est désactivé par défaut, le prompt est donc rendu tel qu’il est écrit. Activé, MiniMax développe d’abord un brief court en une description plus complète du plan, du son et de la musique : des détails que vous n’avez pas écrits peuvent apparaître, et la requête est facturée au tarif expansion du prompt. Les exemples publiés contrent cela par la précision : le prompt de night-train-beckon nomme le velours vert, le laiton poli, la ronce de noyer, une unique lampe de lecture et le geste exact que la caméra doit suivre.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Écrivez-le comme un plan : sujet, mouvement, caméra, lumière, son — dans l’ordre où ils arrivent. 1 caractères minimum · 7000 caractères maximum |
aspect_ratio | Non | Vaut 1:1 par défaut. Réglez 21:9 pour de l’anamorphique, 9:16 pour du vertical. |
duration_seconds | Non | Secondes entières, de 5 à 15. L’omettre vous donne 8, pas 5. |
resolution | Non | 480p ou 768p, 768p par défaut. Les deux sont des rendus natifs ; le 480p coûte moins cher à la seconde. |
enable_prompt_expansion | Non | Désactivé par défaut : le prompt est utilisé tel qu’il est écrit. Valeur par défaut: |
Tarification
| Spécification | Prix |
|---|---|
| $0.05 / seconde |
| $0.08 / seconde |
Cas d’utilisation
Mode et films de campagne
L’exemple silver-corridor est un plan de campagne bâti sur un seul paragraphe : une robe d’argent liquide qui accroche un contre-jour dur, des cheveux soulevés par une machine à vent et, pour finir, un regard droit dans l’objectif, en 21:9 sur cinq secondes, avec un drone de synthé grave dans l’audio. Le mouvement du tissu, la lumière et le regard final sont tous écrits ; aucun n’a été fourni sous forme d’image.
Des rendus d’époque demandés par leur nom
Le caractère d’une pellicule se demande directement. L’exemple roller-rink réclame un rendu des années 1970 avec un fort halo, des couleurs passées, un grain épais et un léger flottement d’image, et loge une action en deux temps dans cinq secondes : un tour de piste lent, puis une glissade à reculons vers la caméra, bras écartés.
Études de matières et de lumière
Les scènes où plusieurs surfaces réagissent à une lumière en mouvement se prêtent bien à un brief écrit. Dans night-train-beckon, les lumières du quai balaient de bandes lumineuses un visage, du satin et des jambes pendant que la caméra avance avec une profondeur de champ très courte. Servez-vous d’un tel brief pour vérifier qu’une idée de lumière se lit avant de fabriquer des images d’ouverture pour image-to-video.
Guide de prompt et conseils pratiques
Écrire le plan dans l’ordre chronologique
Listez sujet, mouvement, caméra, lumière et son dans l’ordre où ils surviennent. Le prompt de silver-corridor parcourt le plan du premier pas jusqu’au regard final, ajoute ensuite le rendu (« anamorphic 2.39:1, deep blacks, glossy specular highlights ») et se termine par le son (« low synth drone »).
Poser les limites autant que l’action
Si vous activez l’expansion, écrivez ce qui doit rester fixe en plus de ce qui doit se produire. Le prompt de night-train-beckon se termine par des contraintes claires : la nuisette et les bas restent portés du début à la fin, et il n’y a ni texte, ni logo, ni autre personne dans le cadre. La prose laisse la tenue, le corps et le cadrage au modèle ; sans ces précisions, les générations successives dérivent.
Passer à image-to-video pour un résultat littéral
Quand une prise trouve l’idée mais que le sujet ne correspond pas exactement au design, générez ou choisissez une image fixe et passez à image-to-video : une image d’ouverture est suivie bien plus fidèlement que la même description dans un prompt. Réglez aussi la durée volontairement, car sans valeur vous obtenez 8 secondes, pas 5.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-max/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "1:1",
"duration_seconds": 8,
"enable_prompt_expansion": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
