Introduction
MiniMax H3 360 Orbit image vers vidéo transforme une photo en une orbite de caméra à 360 degrés autour d’un instant figé, qui se termine sur l’image de départ.
Fonctionnalités et points forts
- Une photo en entrée, une orbite complète à 360 degrés en sortie : votre photo sert de première et de dernière image, si bien que le clip revient à son point de départ.
- L’adaptateur 360 Orbit tourne à une force de 1 avec la consigne exacte sur laquelle il a été entraîné, donc il n’y a aucun prompt à écrire.
- Sans l’adaptateur, le même modèle de base lit une image identique au début et à la fin comme une image fixe et bouge à peine.
- La sortie garde le cadrage de votre photo : une photo carrée donne un clip carré.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | La photo à faire tourner. Elle sert de première et de dernière image, donc le clip boucle. 1 caractères minimum |
resolution | Non | 480p (par défaut), 540p, 768p ou 1080p. Les paliers supérieurs coûtent davantage par seconde ; le cadrage suit toujours votre photo. |
duration_seconds | Non | De 3 à 6 secondes (3 par défaut). Trois secondes donnent un tour net et figé ; les clips plus longs tournent plus lentement et les personnes peuvent commencer à bouger. |
seed | Non | Permet de garder les essais comparables lorsque vous testez différentes photos ou durées. Cela ne garantit pas un clip identique image par image. |
Tarification
Facturé à la seconde de sortie, selon la résolution choisie.
| Spécification | Prix |
|---|---|
| $0.05 / seconde |
| $0.075 / seconde |
| $0.10 / seconde |
| $0.20 / seconde |
Cas d’utilisation
- Portraits d’instant figé : une personne, les cheveux et des détails en suspension restent immobiles pendant que la caméra tourne.
- Looks de mode et de tenues montrés sous tous les angles à partir d’une seule prise.
- Courts clips en boucle pour des publications sociales, qui se terminent exactement là où ils commencent.
Guide de prompt et conseils pratiques
- 3 secondes donnent le figé le plus net : dans nos tests, le sujet, les cheveux et les pétales suspendus sont restés immobiles pendant tout le tour.
- À 6 secondes, l’orbite est plus lente et les personnes peuvent se mettre à bouger, comme un couple qui dansait dans nos tests.
- Les premiers plans chargés peuvent croiser l’objectif : dans un verger encombré, des troncs sont brièvement passés entre la caméra et le sujet.
- Choisissez le format de photo que vous voulez pour le clip.
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-360-orbit/image-to-video",
"input": {
"duration_seconds": 3,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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.
