Introduction
Wan 3.0 Pro Texte vers vidéo écrit un plan à partir d’un prompt et le livre en 1080p, 2K ou 4K, de 2 à 30 secondes, avec le son généré dans le même fichier. prompt est le seul champ obligatoire et accepte jusqu’à 20 000 caractères. Un rendu natif de Wan 3.0 plafonne à 1080p : les paliers 2k et 4k sont donc agrandis à partir de ce rendu, et non dessinés à ces tailles. Ce point de terminaison n’a pas de palier 480p ni 720p ; ces tailles relèvent de Wan 3.0.
Choisir le mode selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| Un brief écrit définit la scène, l’action, la caméra et, si nécessaire, le son. | Wan 3.0 Pro Texte vers vidéo |
| Une image de départ validée fixe le sujet et la composition ; la consigne dirige le mouvement qui suit. | Wan 3.0 Pro Image vers vidéo |
| Des références distinctes peuvent guider l’identité, le lieu, le mouvement ou le son, avec un rôle explicite pour chacune. | Wan 3.0 Pro Références vers vidéo |
Fonctionnalités et points forts
Trois tailles de livraison pour un seul rendu natif
resolution accepte 1080p (par défaut), 2k ou 4k. Les deux paliers supérieurs étirent ce que le modèle a dessiné sans rien dessiner de plus : ils conviennent aux images destinées à être recadrées, trackées ou projetées, et ne valent que ce que vaut le rendu d’origine. Trouvez le plan en 1080p d’abord et considérez la 4K comme une étape de livraison.
L’expansion du prompt est activée d’emblée
Dans cette famille, enable_prompt_expansion vaut true par défaut. Elle étoffe un brief léger, ce qui est pratique en phase d’esquisse, mais réécrit un brief détaillé. Dès que votre prompt décrit précisément le plan, passez le champ à false pour que la formulation que vous avez réglée soit celle qui s’exécute.
Un format adaptatif tant que vous n’en imposez pas
aspect_ratio vaut adaptive par défaut : le modèle choisit le cadre. Indiquez 16:9, 4:3, 1:1, 3:4 ou 9:16 quand le format de livraison est fixé : l’exemple du grillage demande du 9:16 pour un cadre vertical, tandis que les exemples du parfum, du noir et blanc et du tatouage imposent tous le 16:9.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Sujet, une action, un mouvement de caméra, puis la lumière et le son. En 4K, un brief vague coûte de l’argent réel : écrivez le plan, pas une ambiance. 1 caractères minimum · 20000 caractères maximum |
resolution | Non | 1080p, 2k ou 4k, 1080p par défaut. |
aspect_ratio | Non | 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive. Vaut adaptive par défaut, ce qui laisse le modèle choisir ; nommez un format quand la livraison est imposée. |
duration_seconds | Non | N’importe quel nombre entier de 2 à 30, 5 par défaut, ou -1 pour la durée intelligente, où le modèle choisit la longueur : le maximum de 30 secondes est réservé d’avance, puis s… |
generate_audio | Non | Actif par défaut. Le son est généré avec l’image et arrive dans le même fichier. Valeur par défaut: |
enable_prompt_expansion | Non | Active par défaut dans cette famille. Elle étoffe les briefs maigres et réécrit les briefs détaillés : coupez-la dès que votre prompt est une description de plan précise. Valeur par défaut: |
seed | Non | De 0 à 2147483647. Fixez-la pendant que vous réglez la résolution ou la durée, sinon chaque relance change deux choses à la fois. |
Tarification
| Spécification | Prix |
|---|---|
| $0.144 / seconde |
| $0.16 / seconde |
| $0.184 / seconde |
Cas d’utilisation
Films de parfum et de beauté sous lumière dure
L’exemple du parfum est un spot de cinq secondes au ralenti : une femme adulte en robe noire dos dégagé se détourne d’une fenêtre battue par la pluie, une unique lumière principale dure court le long de sa colonne, des gouttes s’échappent de ses cheveux, et la bande-son porte une note grave de violoncelle et la pluie. Le tissu brillant, une source dure unique et les petites particules rapides sont les premiers à se dégrader à l’agrandissement : vérifiez précisément ces zones dans une livraison 2K ou 4K.
Un tissu mû par une seule force extérieure
Deux exemples dirigent le vêtement par une seule force plutôt qu’en décrivant sa tenue. Dans le film de mode en noir et blanc, trois mètres de mousseline de soie devant une soufflerie industrielle fouettent le corps et s’enroulent autour d’une épaule sous une lumière dure sur fond noir. Dans l’exemple du grillage, le souffle d’un avion à l’atterrissage plaque les vêtements de deux personnes contre elles. Nommer la force donne au tissu une cause à suivre.
Guide de prompt et conseils pratiques
Explorez en 1080p, puis refaites le rendu avec la graine retenue
Trouvez le plan à 5 secondes et en 1080p avec seed fixé, changez un champ par relance, puis seulement renvoyez le même prompt et la même graine avec resolution à 4k. Changer la résolution et le texte dans la même relance empêche de savoir lequel a fait bouger le résultat.
Écrivez le plan, pas une humeur
Sujet, une action, un mouvement de caméra, puis lumière et son. Le prompt du salon de tatouage est un bon modèle : des bougies et une lampe de bureau pour seule lumière, des mains gantées qui ombrent un motif sur les côtes, une grimace, une lente expiration et un sourire par-dessus l’épaule, une machine qui bourdonne, un travelling avant très lent. En 4K, un brief vague est une façon coûteuse de découvrir ce que vous vouliez dire.
Nommez les sons que vous voulez entendre
Le son est généré avec l’image : listez donc ses sources. Le spot de parfum demande « low cello note and rain », le film à la soufflerie « the roar of the fan and snapping cloth ». Passez generate_audio à false quand un compositeur signe la musique. La famille accepte les prompts sans censure sans déclaration par requête ; le consentement, les droits, l’âge et le droit local pour toutes les personnes représentées restent sous votre responsabilité.
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-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.
