Introduction
L’API image vers vidéo de MiniMax H3 Lite transforme une image fixe en clip sonore de 4 à 15 secondes en 480p ou 768p. Envoyez une image de départ, éventuellement une image de fin, et testez le mouvement en 480p avant de payer un rendu plus net. 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
L’image fixe le rendu
L’image de départ fixe les visages, les vêtements, la lumière et la composition ; MiniMax H3 Lite consacre donc le prompt à ce qui bouge. Le clip garde la forme de l’image. Le clip épouse le format de votre image et aucun champ de format n’existe : recadrez-la en paysage ou en vertical avant l’envoi.
Image de fin facultative
Envoyez une seconde image comme last_image_url et le clip s’immobilise dessus, ce qui transforme deux images fixes en transition maîtrisée. Au lieu d’inventer une fin, le modèle planifie le mouvement entre les deux images, ce qui aide quand un plan doit se raccorder au suivant.
Son inclus
Le mouvement arrive avec un son correspondant : ressac, pas, rire ou réplique entre guillemets, généré avec l’image sans surcoût. Ajoutez une ligne Audio : si vous voulez un certain style de musique ou une certaine acoustique plutôt que ce que la scène suggère.
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 |
image_url | Oui | Image de départ obligatoire. Le clip garde sa forme. |
last_image_url | Non | Image de fin facultative sur laquelle le clip se termine. 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
Photos produit et mode qui bougent
Une photo de catalogue d’une veste, d’un sac ou d’une paire de chaussures peut ouvrir un court clip sur MiniMax H3 Lite : le modèle marche, tourne ou ramasse l’article en gardant l’éclairage du shooting d’origine, ce qui évite une nouvelle prise de vue pour des mouvements simples.
Donner vie à un portrait
Un portrait unique devient un court clip avec mouvement naturel et son sur MiniMax H3 Lite, sans avoir à décrire le rendu depuis zéro. Un seul sourire, un mouvement de tête ou un pas vers la caméra peut suffire à animer une photo de profil ou une fiche de personnage.
Transitions maîtrisées
Avec une image de départ et une image de fin, MiniMax H3 Lite remplit le mouvement entre deux fixes. Cela convient aux plans avant-après, aux changements de tenue ou aux moments d’histoire où un personnage commence dans une pose et termine dans une autre.
Guide de prompt et conseils pratiques
Décrire le moment suivant, pas l’image
L’image montre déjà qui et où. Réservez le prompt à l’action, au mouvement de caméra et au son qui suivent, dans l’ordre où cela se passe. Redécrire l’image tend à la figer, tandis qu’une première action nette, par exemple elle se tourne vers la fenêtre, la met en mouvement.
Utiliser des images dans les limites
Les images doivent faire de 256 à 5 760 pixels par côté, avec un rapport largeur sur hauteur de 0,4 à 2,5 ; recadrez les panoramas extrêmes avant l’envoi. Une image nette et bien éclairée, avec un sujet bien visible, garde les visages plus stables qu’une image minuscule ou très compressée.
Associer des images cohérentes
Une image de fin fonctionne mieux si elle montre les mêmes personnes et la même pièce que l’image de départ, avec un changement que le prompt peut expliquer, comme une nouvelle pose, un pas de plus vers la caméra ou une autre expression. Deux images sans rapport provoquent un saut de type coupure.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# 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.
