Introduction
Wan 3.0 Spicy Image vers vidéo est l'endpoint image vers vidéo de la famille Wan 3.0 Spicy, réglé pour rendre ce que la version standard atténue. Une image d'ouverture dans image_url et un prompt facultatif produisent 2 à 30 secondes de vidéo en 480p, 720p ou 1080p, avec audio généré. L'image fixe fournit la personne, la tenue, le décor et la lumière ; le prompt fournit le mouvement, la caméra et le son. Ajoutez last_image_url pour fixer la fin.
Il n’y a aucun indicateur de contenu dans le corps de la requête et aucune déclaration par requête. Dans notre test de contenu à six niveaux du 2026-09-30, chaque niveau est revenu tel qu’écrit.
Fonctionnalités et points forts
Six niveaux testés, six rendus
Nous avons lancé notre test de contenu standard en 480p et cinq secondes : six prompts répartis sur cinq niveaux d'intensité, de Léger à Maximum (les prompts de test ne sont pas publiés). Rien n'a été refusé, masqué ni remplacé par une autre personne, et aucun prompt n'a eu besoin d'être adouci.
Il va plus loin que le prompt à lui seul
C'est la partie à prévoir. Dans nos tournages d'exemple, nous avons envoyé six images d'ouverture avec des prompts indiquant que la tenue reste inchangée ; quatre sont revenues avec une tenue modifiée, y compris chaque image comptant plus d'une personne. Considérez le prompt comme une demande, non comme une garantie, et vérifiez le clip en entier.
Jusqu’à 30 secondes en une seule requête
duration_seconds accepte tout nombre entier de 2 à 30, 5 par défaut. Une requête de cinq secondes renvoie environ 5,04 secondes à 30 images par seconde. resolution vaut 480p, 720p (par défaut) ou 1080p, et la durée comme la résolution influent sur le prix et le délai.
Forme, son et dernière image
aspect_ratio accepte 16:9, 9:16, 1:1, 4:3 ou 3:4 ; omis, le clip suit l’image fixe. generate_audio est activé par défaut. last_image_url fixe l’image finale — dans notre test, le clip s’est terminé sur l’image fournie, recadrée au ratio demandé.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Non | Facultatif mais utile : une action, un mouvement de caméra, une indication sur le son. Demander que la tenue reste inchangée ne la garde pas de façon fiable avec ce modèle. 1 caractères minimum |
image_url | Oui | Obligatoire. L’image d’ouverture : la personne, la tenue, la pièce et la lumière en viennent. |
last_image_url | Non | Dernière image facultative. Le clip se termine sur cette image, recadrée au ratio demandé. |
aspect_ratio | Non | 16:9, 9:16, 1:1, 4:3 ou 3:4. Omis, le clip suit la forme de l’image d’ouverture ; un ratio différent recadre l’image. |
resolution | Non | 480p, 720p ou 1080p, 720p par défaut. Une résolution plus élevée coûte plus cher par seconde et prend plus de temps. |
duration_seconds | Non | Tout nombre entier de 2 à 30, 5 par défaut. Facturé à la seconde demandée. |
generate_audio | Non | Activé par défaut, sans supplément : le clip revient avec un son aligné sur l’image. Mettez false pour un clip muet. Valeur par défaut: |
enable_prompt_expansion | Non | Désactivé par défaut, sans supplément. Valeur par défaut: |
seed | Non | De 0 à 2147483647. Gardez-la fixe en comparant résolutions ou durées ; elle rend les essais comparables, pas identiques image par image. |
Tarification
| Spécification | Prix |
|---|---|
| $0.057 / seconde |
| $0.114 / seconde |
| $0.228 / seconde |
Cas d’utilisation
Des scènes que d'autres API refusent
Des scènes que d'autres API refusent ou atténuent : envoyez l'image fixe, décrivez le mouvement, obtenez le clip. Seuls des adultes consentants et des contenus dûment sous licence peuvent être utilisés, et vous êtes responsable des droits, de l'âge et du droit local pour toutes les personnes représentées.
Personnages de compagnie et de jeu de rôle
Gardez l’image fixe d’un personnage et réutilisez-la comme image d’ouverture de chaque clip en ne changeant que l’action. L’image porte le visage et la tenue, si bien que le personnage reste la même personne d’un clip à l’autre.
Longs plans avec une fin planifiée
Demandez jusqu’à 30 secondes et ajoutez last_image_url pour que le plan retombe sur la pose d’où part votre plan suivant.
Guide de prompt et conseils pratiques
Laissez l’image faire le style
Mettez la tenue, la pièce et la lumière dans l’image fixe, et gardez le prompt pour ce qui bouge. L’exemple de la fenêtre sur cette page a tourné avec duration_seconds 5 et resolution 720p :
She turns from the rainy window toward the camera; the loose strap slides a little further down her shoulder and she lets it rest there, a slow half smile. Pink and cyan neon ripples over the wet glass and her collarbone. She stays in the velvet dress the whole time. Slow push-in. Rain on the glass, distant traffic hum.
La requête exacte derrière le clip pour ce point de terminaison, générée à partir de l’image d’ouverture montrée à côté.
Esquissez en 480p, puis rendez
Un clip de cinq secondes en 480p a pris environ une minute et demie dans nos tests. Fixez l’idée à ce stade, gardez seed, puis re-rendez en 720p ou 1080p. Changez un seul champ par essai pour que chaque comparaison vous apprenne quelque chose.
Quand la tenue doit rester
Aucune formulation de prompt n'empêche de façon fiable ce modèle de modifier la tenue d'un sujet. Pour un clip où la garde-robe doit tenir, utilisez le Wan 3.0 image vers vidéo standard et réservez Spicy aux scènes où cette tendance est précisément le but.
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-3.0-spicy/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": "720p"
}
}'
# 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.
