Introduction
Wan 2.2 texte vers vidéo génère un clip à partir d’un prompt écrit, sans autre source. Chaque requête renvoie une seule vidéo muette de cinq secondes, en 16:9 ou 9:16, rendue en 480p ou 720p. Le prompt peut atteindre 5 000 caractères et c’est le seul champ obligatoire : le format est 16:9 par défaut, la résolution 480p, et l’extension du prompt reste désactivée tant que vous ne l’activez pas.
Choisir un mode Wan 2.2 selon le matériau de départ
| Ce dont vous disposez au départ | Mode | Ce que demande la requête |
|---|---|---|
| une scène écrite ou un script | Wan 2.2 texte vers vidéo | un prompt ; 16:9 ou 9:16 |
| une image fixe à conserver | Wan 2.2 image vers vidéo | une image et un prompt ; l’image fixe le format |
Fonctionnalités et points forts
Une prise fixe de cinq secondes
Le texte vers vidéo n’a aucun réglage de durée : chaque prise dure exactement cinq secondes, si bien que la longueur d’une requête est connue avant l’envoi. Cinq secondes portent un seul temps fort (un sujet, une action, un mouvement de caméra), pas un enchaînement d’événements. Les prompts calibrés à cette échelle donnent les résultats les plus fiables.
Deux formats, deux résolutions
Le format est 16:9 par défaut, ou 9:16 pour une diffusion verticale. Les cadres carrés et 4:3 ne sont pas proposés : pour une livraison carrée, générez en 16:9 puis recadrez au montage. La résolution est de 480p ou 720p, et c’est le seul réglage qui modifie le prix, ce qui fait du 480p le palier naturel pour les brouillons.
L’image seule
Les clips sont livrés sans piste audio et aucun réglage audio n’existe. Tout ce que le spectateur doit ressentir doit donc se voir : l’exemple publié du quai enneigé construit son rythme avec la neige qui tombe, la buée des respirations dans le froid et une lampe de quai qui vacille, au lieu de compter sur une ambiance sonore.
Extension du prompt et seed en option
L’extension du prompt réécrit une consigne courte en version plus complète avant la génération. Le seed accepte les valeurs de 0 à 2147483647 et fige la source aléatoire pour comparer une modification à la fois ; il ne garantit pas un clip identique image par image lors d’une nouvelle exécution.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Le plan lui-même, en 5 000 caractères au plus : qui, une action, un mouvement de caméra, puis la lumière. Un verbe net fait bouger le résultat davantage qu’une pile d’adjectifs. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | 16:9 ou 9:16, 16:9 par défaut. Ni carré ni 4:3 sur ce point de terminaison. |
resolution | Non | 480p ou 720p, 480p par défaut. C’est le seul réglage qui modifie le prix. |
enable_prompt_expansion | Non | Désactivé par défaut. Activé, un brief court est réécrit en version plus complète avant la génération ; laissez-le désactivé dès que votre prompt décrit précisément le plan. Valeur par défaut: |
seed | Non | De 0 à 2147483647. Gardez-le fixe pour comparer une modification à la fois ; omettez-le pour varier les résultats. |
Tarification
Chaque requête renvoie un clip de cinq secondes.
| Spécification | Prix |
|---|---|
| $0.24 / requête |
| $0.48 / requête |
Cas d’utilisation
Des brouillons de storyboard en série
Écrivez chaque temps fort du storyboard dans un prompt distinct et rendez toute la liste en 480p. Cinq secondes suffisent pour juger le cadrage et le mouvement, et comme chaque requête a la même durée et un prix fixé par la seule résolution, le coût d’un lot est connu avant l’envoi. Rendez ensuite en 720p les prises retenues, avec le même prompt et le même seed.
Des clips verticaux pour les réseaux sociaux
Réglez le format sur 9:16 et décrivez une seule action continue. L’exemple publié du marché de nuit fait exactement cela en 720p : une jeune femme en ciré jaune prend une brochette à un stand de grillades, la fumée et la vapeur montent entre des guirlandes d’ampoules, puis elle se retourne et marche vers la caméra, qui avance lentement à l’épaule.
Vérifier qu’une idée de plan tient en mouvement
Avant de lancer une prise en 720p, vous pouvez tester l’idée à moindre coût. L’exemple de l’escalier du phare est écrit comme une action et une position de caméra (un homme âgé, lanterne à la main, gravit le dernier tour d’un escalier en colimaçon, suivi par une caméra placée bas) et rendu en 16:9 à 480p.
Guide de prompt et conseils pratiques
Écrire un temps fort dans un ordre fixe
Nommez le sujet, l’action unique, un mouvement de caméra, puis la lumière. Un verbe précis fait davantage bouger le résultat qu’une pile d’adjectifs : un homme qui gravit le dernier tour d’un escalier et s’arrête devant une fenêtre donne au clip un début et une fin en cinq secondes.
Consacrer les caractères aux détails, pas à d’autres scènes
La limite de 5 000 caractères laisse la place de décrire costumes, décor, météo et lumière, mais cinq secondes ne portent pas un deuxième événement. Si une consigne en contient plusieurs, répartissez-les sur des requêtes distinctes et assemblez les clips au montage.
Garder le seed pendant les révisions
Choisissez un seed et conservez-le tant que vous ne changez qu’un seul élément, par exemple un verbe, le mouvement de caméra ou le format. L’exemple du marché de nuit fixe le seed 250728 pour que le même cadrage puisse être comparé d’une version du prompt à l’autre. Omettez le seed quand vous cherchez de la variété.
Trancher tôt sur l’extension du prompt
Pour une idée tenant en une ligne, activer l’extension du prompt laisse le service rédiger une consigne plus complète à votre place. Dès que votre prompt nomme le sujet, l’action, la caméra et la lumière, laissez-la désactivée pour que le texte soit exécuté tel quel, et jugez toujours une version étendue face à une version sans extension.
Savoir quand le texte ne suffit pas
Un prompt seul ne maintient pas un visage ou un produit précis d’une exécution à l’autre. Quand le sujet doit correspondre à une image fixe validée, passez à Wan 2.2 image vers vidéo et laissez l’image porter l’apparence.
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.2/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
# 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.




























