Introduction
Image vers vidéo avec MiniMax H3 HighSpeed part d’une image fixe que vous avez déjà et l’anime en MP4 de 4 à 15 secondes en 768p, avec son. L’image fixe le rendu ; le prompt n’a qu’à dire ce qui bouge.
Quel mode HighSpeed choisir pour votre point de départ
| Ce que vous avez | Mode |
|---|---|
| seulement une idée | MiniMax H3 HighSpeed texte vers vidéo |
| une image à animer, avec une image de fin facultative | MiniMax H3 HighSpeed image vers vidéo |
| des personnes, des tenues, des lieux, des clips de mouvement ou des voix | MiniMax H3 HighSpeed référence vers vidéo |
Fonctionnalités et points forts
L’image fixe le rendu
Les visages, les vêtements, la lumière et la composition viennent de votre image de départ. Le clip en garde la forme et il n’existe pas de champ de format : recadrez donc l’image au format voulu, large ou vertical, avant de l’envoyer.
Image de fin facultative
Ajoutez last_image_url et le clip se pose sur cette seconde image, ce qui vous donne un mouvement maîtrisé entre deux images fixes. Cela aide quand un plan doit s’enchaîner proprement avec le suivant.
Son inclus
Le mouvement arrive avec un son adapté, comme le ressac, des pas, un rire ou une réplique entre guillemets, sans supplément. Une ligne Audio: dans le prompt oriente le style musical ou l’ambiance sonore de la pièce.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire. Accepte de 1 à 7 000 caractères et refuse tout ce qui dépasse. 1 caractères minimum · 7000 caractères maximum |
image_url | Oui | Image de départ obligatoire dont le clip reprend la forme. Chaque côté doit mesurer de 256 à 5 760 pixels, avec un rapport largeur sur hauteur entre 0,4 et 2,5. |
last_image_url | Non | Image de fin facultative sur laquelle le clip se pose. N’ajoute rien au prix. |
resolution | Non |
|
duration_seconds | Non | Un nombre entier de 4 à 15 (5 par défaut), chaque seconde étant facturée au tarif 768p. Une demande de 4 secondes est revenue sous la forme d’un clip de 3,75 secondes. |
Tarification
Vous payez chaque seconde du clip terminé en 768p ; le tarif en direct figure sur la page du modèle.
| Spécification | Prix |
|---|---|
| $0.072 / 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 où l’article est porté, tourné ou saisi, avec l’éclairage de la prise de vue d’origine.
Donner vie à un portrait
Un seul portrait devient un court clip avec un sourire, un mouvement de tête ou un pas vers la caméra, ce qui suffit à donner vie à une photo de profil ou à une carte de personnage.
Transitions maîtrisées
Avec une image de départ et une image de fin, le modèle comble le mouvement qui les sépare : plans avant et après, changements de tenue, ou personnage qui commence dans une pose et finit dans une autre.
Guide de prompt et conseils pratiques
Décrire le moment suivant, pas l’image
Utilisez le prompt pour ajouter une courte séquence à l’image : un produit qui se tourne vers son étiquette, un portrait qui lève les yeux, une caméra qui se rapproche. Mettez l’action d’abord, puis la caméra, puis le son.
Utiliser des images dans les limites
Gardez chaque côté entre 256 et 5 760 pixels et le rapport largeur sur hauteur entre 0,4 et 2,5. La sortie suit la forme de votre image en 768p : vérifiez les visages, les étiquettes et les bords dans le résultat avant de publier.
Associer des images cohérentes
Donnez à l’image de départ et à l’image de fin le même cadrage et le même format, et prévoyez une seule transition tenant en 4 à 15 secondes. Regardez la dernière seconde pour vérifier que le plan atterrit bien sur l’image de fin.
Vous payez chaque seconde du clip terminé en 768p ; le tarif en direct figure 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-highspeed/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.
