Introduction
L’API texte vers vidéo de MiniMax H3 Lite génère des clips sonores de 4 à 15 secondes en 480p ou 768p. Écrivez la scène une fois, puis relancez-la en ne changeant qu’un détail à la fois pour voir quelle prise convient. Cette version légère convient pour tester des idées et produire plusieurs variantes. Chaque requête produit un seul MP4 où l’image et le son sont générés ensemble.
Quel mode pour quel point de départ
| Votre point de départ | Mode à ouvrir |
|---|---|
| seulement une idée | MiniMax H3 Lite texte vers vidéo |
| une image à animer, avec une image de fin facultative | MiniMax H3 Lite image vers vidéo |
| des personnes, des tenues, des lieux, des clips de mouvement ou des voix | MiniMax H3 Lite référence vers vidéo |
Fonctionnalités et points forts
Son et dialogues en une seule passe
Chaque clip MiniMax H3 Lite arrive avec son. Les répliques entre guillemets sont prononcées, et la musique ou l’ambiance suit les mots que vous utilisez pour les décrire ; une courte scène n’a donc pas besoin d’étape audio séparée.
Six formats
16:9, 9:16, 1:1, 4:3, 3:4 et 21:9 sont disponibles sans changer le prix ; le même prompt peut donc alimenter une bande-annonce horizontale et un montage vertical pour les réseaux sociaux.
Deux niveaux de prix
Le 480p coûte environ 40 % de moins par seconde que le 768p, ce qui en fait le moyen économique d’explorer un prompt avant de rendre la version finale.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, jusqu’à 7 000 caractères ; un prompt plus long est rejeté. Mettez les répliques entre guillemets. 1 caractères minimum · 7000 caractères maximum |
aspect_ratio | Non | L’un de 16:9 (par défaut), 9:16, 1:1, 4:3, 3:4 ou 21:9. Ne change pas le prix. |
resolution | Non |
|
duration_seconds | Non | Nombre entier de secondes, entre 4 et 15, 5 par défaut. Facturé à la seconde avec la résolution. |
Tarification
Chaque seconde de sortie est facturée au tarif de la résolution choisie, 480p ou 768p. Le tarif en vigueur est toujours affiché sur la page du modèle.
| Spécification | Prix |
|---|---|
| $0.025 / seconde |
| $0.04 / seconde |
Cas d’utilisation
Storyboards et clips de présentation
Faites d’une liste de plans écrite des aperçus animés sommaires avant tout engagement de production. Chaque prompt sur MiniMax H3 Lite renvoie un clip fini avec son : la salle entend la scène autant qu’elle la voit, et une idée faible peut être abandonnée avant qu’on ait dépensé quoi que ce soit de coûteux.
Brouillons de prompts en volume
Auteurs et développeurs d’applications peuvent tester de nombreuses versions d’une scène sur MiniMax H3 Lite et garder celle qui fonctionne, en ne payant que la seconde de sortie. En ne changeant qu’une chose par essai, caméra, tenue ou réplique, vous voyez vite quelle version mérite un rendu plus net.
Clips verticaux avec une réplique
Une scène 9:16 de 5 à 8 secondes, avec une réplique citée et une ambiance, s’intègre directement aux formats sociaux depuis MiniMax H3 Lite, sans passe de montage pour le son. Si vous publiez souvent, gardez un réglage fixe et ne variez que l’action et la réplique : chaque brouillon de 4 secondes en 480p coûte $0.10.
Guide de prompt et conseils pratiques
Écrire la scène dans l’ordre
Décrivez qui est là, ce qu’il fait d’abord puis ensuite, où se trouve la caméra, et terminez par une ligne Audio : pour le son. Un ordre clair se lit mieux qu’un tas d’adjectifs, et nommer la lumière, heure dorée ou néon par exemple, fixe l’ambiance d’emblée.
Garder les dialogues courts
Une ou deux répliques entre guillemets conviennent à un clip de 5 à 8 secondes ; indiquez qui prononce chaque réplique pour que la bonne personne bouge les lèvres. Les longs discours sont expédiés ou tronqués ; répartissez-les sur plusieurs clips.
Brouillonner à petit prix, finir net
Itérez en 480p, puis rendez la version retenue en 768p avec le même prompt ; la composition se reporte de très près.
Chaque seconde de sortie est facturée au tarif de la résolution choisie, 480p ou 768p. Le tarif en vigueur est toujours affiché sur la page du modèle.
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-lite/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.
