Introduzione
Wan 3.0 Spicy Immagine-a-video è l'endpoint immagine-a-video della famiglia Wan 3.0 Spicy, calibrato per rendere ciò che la versione standard attenua. Un fotogramma iniziale in image_url e un prompt facoltativo producono da 2 a 30 secondi di video in 480p, 720p o 1080p, con audio generato. Il fermo immagine fornisce persona, abbigliamento, scena e luce; il prompt fornisce movimento, camera e suono. Aggiungi last_image_url per fissare il finale.
Nel corpo della richiesta non c’è alcun flag di contenuto né dichiarazione per singola richiesta. Nel nostro test di contenuto a sei livelli del 2026-09-30 ogni livello è tornato come scritto.
Caratteristiche principali
Sei livelli testati, sei resi
Abbiamo eseguito il nostro test di contenuto standard a 480p e cinque secondi: sei prompt su cinque livelli di intensità, da Lieve a Massimo (i prompt di test non sono pubblicati). Nulla è stato rifiutato, coperto o sostituito con un'altra persona, e nessun prompt ha avuto bisogno di essere attenuato.
Va oltre il prompt da solo
È la parte per cui pianificare. Nelle nostre riprese di esempio abbiamo inviato sei fotogrammi iniziali con prompt che dicevano che l'abbigliamento resta com'è; quattro sono tornati con l'abbigliamento cambiato, compreso ogni fotogramma con più di una persona. Considera il prompt una richiesta, non una garanzia, e controlla l'intera clip.
Fino a 30 secondi in una sola richiesta
duration_seconds accetta qualsiasi numero intero da 2 a 30, predefinito 5. Una richiesta da cinque secondi restituisce circa 5,04 secondi a 30 fotogrammi al secondo. resolution è 480p, 720p (predefinito) o 1080p, e sia la durata sia la risoluzione incidono su prezzo e tempi.
Forma, suono e ultimo fotogramma
aspect_ratio accetta 16:9, 9:16, 1:1, 4:3 o 3:4; se omesse, il clip segue il fermo immagine. generate_audio è attivo per impostazione predefinita. last_image_url fissa il fotogramma finale: nel nostro test il clip è terminato sull’immagine fornita, ritagliata alle proporzioni richieste.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Facoltativo ma utile: un'azione, un movimento di camera, una nota sul suono. Chiedere che l'abbigliamento resti invariato non lo mantiene in modo affidabile su questo modello. almeno 1 caratteri |
image_url | Sì | Obbligatorio. Il fotogramma iniziale: persona, outfit, ambiente e luce vengono tutti da qui. |
last_image_url | No | Ultimo fotogramma facoltativo. Il clip termina su questa immagine, ritagliata alle proporzioni richieste. |
aspect_ratio | No | 16:9, 9:16, 1:1, 4:3 o 3:4. Se omesse, il clip segue la forma del fotogramma iniziale; proporzioni diverse lo ritagliano. |
resolution | No | 480p, 720p o 1080p, predefinito 720p. Una risoluzione più alta costa di più al secondo e richiede più tempo. |
duration_seconds | No | Qualsiasi numero intero da 2 a 30, predefinito 5. Fatturato al secondo richiesto. |
generate_audio | No | Attivo per impostazione predefinita, senza costi aggiuntivi: il clip torna con un suono allineato alle immagini. Imposta false per un clip muto. Predefinito: |
enable_prompt_expansion | No | Disattivato per impostazione predefinita, senza costi aggiuntivi. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fermo mentre confronti risoluzioni o durate; rende i risultati confrontabili, non identici fotogramma per fotogramma. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.057 / secondo |
| $0.114 / secondo |
| $0.228 / secondo |
Casi d’uso
Scene che altre API rifiutano
Scene che altre API rifiutano o attenuano: invia il fermo immagine, descrivi il movimento, ottieni la clip. Si possono usare solo adulti consenzienti e materiale con licenza adeguata, e sei responsabile di diritti, età e legge locale per tutte le persone ritratte.
Personaggi di compagnia e di roleplay
Conserva il fermo immagine di un personaggio e riusalo come fotogramma iniziale di ogni clip, cambiando solo l’azione. Il fermo immagine porta volto e outfit, così il personaggio resta la stessa persona da un clip all’altro.
Inquadrature lunghe con un finale pianificato
Chiedi fino a 30 secondi e aggiungi last_image_url perché l’inquadratura arrivi sulla posa da cui parte la successiva.
Consigli avanzati
Lascia che sia il fotogramma a fare lo styling
Metti guardaroba, ambiente e luce nel fermo immagine e tieni il prompt per ciò che si muove. L’esempio della finestra in questa pagina è girato con duration_seconds 5 e 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 richiesta esatta dietro il clip per questo endpoint, generata dal fotogramma iniziale mostrato accanto.
Bozza a 480p, poi render
Un clip da cinque secondi a 480p ha richiesto circa un minuto e mezzo nei nostri test. Metti a punto l’idea lì, tieni fermo seed, poi rigenera a 720p o 1080p. Cambia un solo campo per esecuzione, così ogni confronto ti insegna qualcosa.
Quando l’outfit deve restare
Nessuna formulazione del prompt impedisce in modo affidabile a questo modello di cambiare l'abbigliamento di un soggetto. Per una clip in cui il guardaroba deve restare, usa il Wan 3.0 standard immagine-a-video e tieni Spicy per le scene in cui proprio quella inclinazione è lo scopo.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
