Introduction
Wan 3.0 Pro Prime Texte vers vidéo génère un plan de 2 à 30 secondes à partir d’un prompt et le livre en 1080p, 2K ou 4K avec le son dans le même fichier. Sa liste de champs est exactement celle de Wan 3.0 Pro Texte vers vidéo, mais le rendu de base est Wan 3.0 Prime, qu’Alibaba présente comme la version haute vitesse aux capacités identiques. Un rendu natif de Prime plafonne à 1080p : les paliers 2k et 4k en sont agrandis plutôt que rendus nativement.
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 Prime 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 Prime 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 Prime Références vers vidéo |
Fonctionnalités et points forts
Le même corps de requête que Wan 3.0 Pro
prompt (jusqu’à 20 000 caractères) est le seul champ obligatoire ; resolution vaut 1080p par défaut, aspect_ratio vaut adaptive et enable_prompt_expansion vaut true. Le contrat étant identique, un même corps JSON fonctionne sur Pro et sur Pro Prime en changeant seulement le nom du modèle : envoyez un plan test aux deux avec la même graine avant d’engager un projet sur l’un d’eux.
Le cadrage écrit dans le brief
L’exemple de la crypte consacre un tiers de son prompt au seul cadrage : la tête entière dans le cadre, de l’air au-dessus des cheveux, le cadre coupé à la taille, le visage visible en permanence. En gros plan, l’échec habituel est que le modèle coupe le visage hors de son propre cadre, et nommer le cadrage est le remède. La lumière des bougies est la seule source principale, et le son — flammes qui vacillent, une porte de fer au loin — arrive dans le même passage.
Un mouvement sans point d’appui
L’exemple sous-marin n’a aucun sol de référence : une robe de soie pourpre qui s’épanouit pendant que le sujet coule, des cheveux déployés en éventail, des bulles qui s’échappent du bout des doigts, et une caméra qui décrit un arc tout en basculant. Il ne précise pas de résolution et tourne donc au 1080p par défaut. Les plans où rien ne se pose sont ceux qui profitent le plus d’un palier de livraison plus grand.
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.234 / seconde |
| $0.252 / seconde |
| $0.279 / seconde |
Cas d’utilisation
Une lumière colorée en mouvement dans un cadre vertical
L’exemple de l’aurore demande une lumière verte qui court sur la peau et les cheveux de deux personnes partageant une couverture sur un lac gelé, en 9:16. Une lumière colorée qui se déplace sur la peau est l’endroit où le banding et le bruit chromatique apparaissent en premier : ne commandez de la 2K ou de la 4K pour ce type de sujet que si la scène l’exige vraiment ; un sujet statique en 4K ne vous apporte qu’un fichier plus lourd.
Des scènes à l’épaule en lumière naturelle
L’exemple du ferry de nuit est volontairement sobre : cadrage documentaire à l’épaule, un projecteur de pont et les lumières lointaines du port, deux hommes adultes au bastingage arrière qui rapprochent leurs fronts puis s’embrassent pendant que le sillage bouillonne en contrebas. Il n’y a aucun drapeau de contenu à définir, puisque chaque scène s’envoie comme n’importe quel prompt ; consentement, droits, âge et droit local restent sous votre responsabilité.
Guide de prompt et conseils pratiques
Explorez en petit, livrez en grand
Réglez le prompt en 1080p et sur 5 secondes avec seed fixé. Quand la prise fonctionne, renvoyez exactement le même corps de requête avec resolution à 4k. Changer la résolution et la graine en même temps change deux choses d’un coup et masque celle qui a fait bouger le résultat.
Dans un fichier agrandi, vérifiez d’abord la lumière dure
Une source dure unique la nuit — une ampoule suspendue, un projecteur de pont — est l’endroit où les images agrandies montrent d’abord leurs limites : banding dans la décroissance, peau cireuse, tissu mouillé qui tourne à la traînée grise. Contrôlez ces zones dans le fichier 2K ou 4K livré avant l’étalonnage ou le montage d’une séquence.
Figez le texte avant le rendu final
Dans cette famille, l’expansion du prompt est activée par défaut et réécrit les briefs détaillés. Désactivez enable_prompt_expansion dès que le prompt se lit comme une description précise du plan, pour que la version réglée soit celle qui s’exécute. Écrivez le sujet, une action, un mouvement de caméra, puis la lumière et le son.
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-prime/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.
