Introduction
Wan 2.6 Image vers vidéo part de l’image que vous envoyez dans image_url et renvoie exactement 5, 10 ou 15 secondes en 720p ou 1080p, avec le son. L’image fixe le sujet, la garde-robe, le décor, la direction de la lumière et les proportions du clip. Le prompt est facultatif et contient jusqu’à 1 500 caractères : une action pour une prise unique, ou des plans numérotés pour un montage à plusieurs plans.
Choisir le mode selon le matériau de départ
| Ce dont vous disposez au départ | Mode |
|---|---|
| une scène ou un script écrit | Wan 2.6 Texte vers vidéo |
| une image de départ validée | Wan 2.6 Image vers vidéo |
| des références distinctes pour l’apparence, le mouvement ou le son | Wan 2.6 Références vers vidéo |
Fonctionnalités et points forts
L’image décide du format et de l’apparence
Il n’existe pas de champ de format : le clip garde les proportions de l’image envoyée, donc une livraison en 9:16 commence par un recadrage en 9:16. L’image peut être en JPEG, en PNG sans transparence, en BMP ou en WEBP, de 240 à 8 000 pixels de côté et 20 Mo au maximum. Tout ce qui y est visible est déjà décidé, ce qui laisse le prompt libre de décrire le mouvement.
Une couverture découpée dans une seule image
Avec shot_type sur multi, le modèle peut couper entre plusieurs angles tout en gardant le rendu de l’image de départ : un clip de quinze secondes peut ainsi porter un plan d’ensemble, un détail et une chute au lieu d’un seul mouvement de caméra qui dérive. Une requête multi s’exécute toujours avec l’expansion du prompt activée. Restez sur single pour les rotations de produit, les plans face caméra et tout ce qui doit rester continu, car multi rompt la continuité par principe.
Un son généré ou fourni
Le clip revient avec un audio généré dans le même passage que l’image. Pour que la parole ou les temps forts musicaux tombent là où vous les attendez, envoyez audio_url : WAV ou MP3, de 3 à 30 secondes, jusqu’à 15 Mo. Une piste plus longue est coupée à la durée du clip ; avec une piste plus courte, le reste du clip est muet.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
image_url | Oui | L'image d'ouverture. Sujet, tenue, décor, direction de la lumière et proportions du clip en découlent : recadrez-la d'abord. |
prompt | Non | Facultatif. Une action pour un plan continu, ou des plans numérotés pour un montage multi-plans. 1 caractères minimum · 1500 caractères maximum |
negative_prompt | Non | Ce qui ne doit pas apparaître : une deuxième personne, des sous-titres, un accessoire que l'image ramène sans cesse. 500 caractères au maximum. 500 caractères maximum |
resolution | Non | 720p ou 1080p, 720p par défaut. Elle fixe le tarif à la seconde et le temps de traitement. |
duration_seconds | Non | Exactement 5, 10 ou 15. Le multi-plans a besoin des durées longues pour respirer. |
audio_url | Non | Une réplique ou un repère musical à suivre, pour que la parole et les temps forts tombent là où vous les attendez. WAV ou MP3, de 3 à 30 secondes, 15 Mo au maximum. |
shot_type | Non | single garde un plan continu ; multi laisse le modèle couper entre plusieurs plans, idéal pour une petite histoire mais au prix de la continuité. |
enable_prompt_expansion | Non | Désactivée par défaut. Activée, elle transforme une idée en une ligne en liste de plans pour multi ; laissez-la coupée si votre prompt est déjà précis. Valeur par défaut: |
seed | Non | De 0 à 2147483647. Figez-la pour comparer single et multi à partir de la même image. |
Tarification
| Spécification | Prix |
|---|---|
| $0.09 / seconde |
| $0.135 / seconde |
Cas d’utilisation
Un macro produit qui ne doit pas sauter
L’exemple du sérum anime une photo de flacon compte-gouttes pendant cinq secondes en 1080p avec un seed fixe. Une seule goutte tombe de l’embout, des anneaux s’étendent sur le liquide et le reflet lumineux sur le verre s’éclaircit légèrement, le tout en cadrage macro fixe avec un léger tintement de verre. Il reste en prise unique, parce qu’un plan produit ne doit pas couper entre les angles.
Une courte histoire d’intérieur à partir d’une photo
L’exemple de l’appartement le soir dure 15 secondes en 720p, avec shot_type sur multi et l’expansion du prompt activée. Une seule image d’intérieur fournit trois plans : la lampe vacille pendant que les lumières de la ville s’allument dehors, une couverture pliée glisse du fauteuil, puis la porte d’entrée s’ouvre et répand la lumière du couloir sur le parquet, sur une ambiance calme et une circulation lointaine.
Un personnage qui dit votre propre texte
Associez l’image d’un personnage à une réplique enregistrée dans audio_url pour que la parole tombe là où vous l’attendez plutôt que sous forme de mouvement générique. Les plans face caméra relèvent de single, et il vaut la peine de vérifier toute la durée : si la piste est plus courte que le clip, la fin reste muette.
Guide de prompt et conseils pratiques
Préparer l’image avant d’écrire un mot
Recadrez au format de livraison et vérifiez que l’image montre déjà la garde-robe, le décor et la lumière voulus, car aucun prompt ne rattrape une mauvaise première image. Retirez les incrustations ou un second sujet que vous ne voulez pas animer, et utilisez negative_prompt, jusqu’à 500 caractères, pour ce que l’image ramène sans cesse, comme un accessoire ou du texte à l’écran.
Décrire le mouvement, pas ce qui est déjà visible
Pour une prise unique, écrivez une action et un mouvement de caméra. Le prompt du sérum nomme la goutte, les anneaux, le changement du reflet, le cadrage et un son, et ne dit rien de la forme du flacon ni de son étiquette, puisque l’image les porte déjà.
A single drop falls from the dropper tip into the bottle and sends slow rings across the liquid surface; the light band on the glass brightens a little. Locked macro framing, soft chime of glass.
Planifier un montage à plusieurs plans
Écrivez des plans numérotés, chacun avec son propre cadrage, et choisissez 10 ou 15 secondes pour laisser de la place aux coupes. Choisir multi active enable_prompt_expansion pour cette requête. Pour une prise unique, l’option est désactivée par défaut, ce qui envoie un prompt précis tel qu’il est écrit.
Comparer single et multi depuis la même image
Fixez seed, qui accepte de 0 à 2147483647, gardez l’image et le prompt inchangés, et lancez la requête une fois en single et une fois en multi pour voir ce qui sert le plan. La résolution fixe le tarif à la seconde et la durée de la tâche : mettez donc la formulation au point en 720p avant de rendre en 1080p. Un seed fixe stabilise la comparaison sans promettre un rendu identique image par image.
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": "alibaba/wan-2.6/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.




























