Wan 2.2 API

Wan 2.2 image vers vidéo part d’une image que vous fournissez et anime ce qui se passe ensuite. Deux entrées sont obligatoires : une image d’ouverture en JPEG, PNG ou WebP de 10 Mo au maximum, et un prompt de 5 000 caractères au plus qui décrit le mouvement. Chaque requête renvoie un seul clip muet de cinq secondes, en 480p (par défaut) ou en 720p.

Choisir un mode Wan 2.2 selon le matériau de départ

L’image porte l’apparence

Le sujet, la tenue, le décor et la direction de la lumière proviennent tous de l’image d’ouverture ; le prompt n’a donc pas à les décrire à nouveau. C’est ce qui rend ce mode adapté aux contenus qui doivent correspondre à une référence : dans l’exemple du flacon de sérum, l’image fige l’étiquette et la silhouette, et le prompt ne demande qu’un arc de caméra et une lumière qui se déplace.

Le format vient de l’image

Ce point de terminaison n’a pas de réglage de format. Le 16:9 et le 9:16 sont les proportions les plus sûres, car une image aux proportions différentes peut revenir redimensionnée et recadrée au centre. Recadrez l’image au format de livraison avant de l’envoyer.

Durée fixe, image seule

Chaque prise dure cinq secondes, sans son, et ni la durée ni l’audio ne peuvent être modifiés. Ces deux paramètres étant figés, le mouvement est la seule variable : c’est pourquoi chaque exemple publié demande un seul mouvement, ou une seule relation de cause à effet.

L’extension du prompt change plus que la formulation

L’extension du prompt est désactivée par défaut. Activée, elle peut modifier l’aspect du rendu et pas seulement le texte de la consigne ; comparez donc avec une exécution sans extension avant de la conserver. L’exemple du carillon et de la silhouette la laisse désactivée pour que sa phrase soit exécutée exactement telle qu’elle est écrite.

Animer une photo produit

Envoyez un packshot validé et demandez un mouvement de caméra ou un changement de lumière, le produit restant à sa place. L’exemple du flacon de sérum montre le schéma : la caméra décrit lentement un quart de tour autour d’un flacon compte-gouttes, une bande douce de lumière de fenêtre glisse sur le verre, et le prompt précise que le flacon lui-même ne bouge pas.

Un seul temps de jeu à partir d’un portrait

L’exemple de la robe nuisette part d’un portrait de studio et ne demande qu’une action : elle transfère son poids, tourne les épaules vers l’objectif, fait deux pas lents et tient le regard. La caméra est fixe, le fond gris du studio reste intact, et la prise est rendue en 720p.

Un mouvement dont on voit la cause

Dans l’exemple du carillon et de la silhouette, un carillon éolien tourne et une forme derrière un rideau de gaze bouge avec lui, tandis que l’ombre du rideau traverse la scène. Écrire une cause et un effet dans un clip court et muet donne une raison au mouvement et l’empêche de ressembler à une boucle.

# 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.2/image-to-video",
  "input": {
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "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.