Wan 2.5 API
Alibaba Wan 2.5 — text-to-video e image-to-video fino a 1080p con audio sincronizzato, più video-extend, image-edit e text-to-image nella stessa famiglia, con varianti Fast degli endpoint video.
Questa guida all'API Wan 2.5 copre gli endpoint attivi su WaveSpeedAI: text-to-video, image-to-video e video-extend con varianti Fast, image-edit e text-to-image. Playground, esempi, prezzi ed esempi di codice qui sotto usano tutti gli endpoint Wan 2.5 attivi.
Panoramica
Informazioni su Wan 2.5 API
Cosa fa Wan 2.5, come si inserisce nella gamma di modelli di Alibaba e perché i team lo scelgono.
Wan 2.5 è un modello di generazione video di Alibaba, disponibile tramite l'API REST di WaveSpeedAI. Alibaba Wan 2.5 — text-to-video e image-to-video fino a 1080p con audio sincronizzato, più video-extend, image-edit e text-to-image nella stessa famiglia, con varianti Fast degli endpoint video.
Questa guida all'API Wan 2.5 copre gli endpoint attivi su WaveSpeedAI: text-to-video, image-to-video e video-extend con varianti Fast, image-edit e text-to-image. Playground, esempi, prezzi ed esempi di codice qui sotto usano tutti gli endpoint Wan 2.5 attivi.
La famiglia Wan 2.5 su WaveSpeedAI offre 8 endpoint REST che coprono i flussi di lavoro Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Ogni variante ha il suo prezzo, i suoi parametri e i suoi esempi di output: scegli quella più adatta alla tua modalità di input e ai tuoi vincoli di produzione, oppure richiamane diverse con la stessa chiave API per comporre pipeline in più passaggi.
Usa Wan 2.5 con la stessa chiave API, lo stesso account di fatturazione e gli stessi limiti di frequenza che usi per gli altri oltre 1.000 modelli AI di WaveSpeedAI. Nessuna configurazione separata per fornitore, nessun SDK per provider, nessun limite di frequenza per fornitore: un'unica integrazione copre tutto, dal text-to-image e text-to-video alla sintesi audio, alla generazione 3D, all'upscaling e all'editing.
Specifiche
Funzionalità e stato di rilascio di Wan 2.5 API
I dettagli specifici del modello che gli sviluppatori cercano prima di scegliere un'API: disponibilità, durata prevista dell'output, supporto dei riferimenti e l'alternativa attiva al momento.
Disponibilità
Attivo ora
Gli endpoint Wan 2.5 sono attivi nel catalogo WaveSpeedAI: text-to-video, image-to-video e video-extend (ciascuno con una variante Fast), image-edit e text-to-image, tutti sullo stesso flusso di predizione REST.
Risoluzioni
480p, 720p, 1080p
L'output video è disponibile a 480p, 720p e 1080p a seconda dell'endpoint; il text-to-video offre formati orizzontali e verticali a ciascuna risoluzione.
Durata
Da 3 a 10 secondi
Il text-to-video genera clip di 5 o 10 secondi; l'image-to-video Fast e il video-extend generano da 3 a 10 secondi.
Audio
Audio sincronizzato
Gli endpoint video generano audio sincronizzato con l'immagine, e un file audio opzionale (WAV o MP3, di almeno 3 secondi, fino a 15 MB) può guidare la generazione.
Varianti Fast
Text, image ed extend
Wan 2.5 Fast è disponibile per text-to-video, image-to-video e video-extend, pensato per una generazione più veloce ed economica.
Strumenti per immagini
Edit e text-to-image
image-edit accetta fino a due immagini in ingresso con un prompt, e text-to-image genera still nella stessa famiglia degli endpoint video.
Endpoint
Tutti gli endpoint API Wan 2.5
8 endpoint Wan 2.5 disponibili ora su WaveSpeedAI: scegli la variante più adatta al tuo flusso di lavoro.
/filters:quality(82)/media/images/20260408104220_jymu91ex.webp)
Wan 2.5 Image Edit
Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104211_97h9m7p7.webp)
Wan 2.5 Text To Image
WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104203_64hpvi1b.webp)
Wan 2.5 Video Extend Fast
WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104158_jzbs7q2h.webp)
Wan 2.5 Video Extend
WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104214_334vajy7.webp)
Wan 2.5 Text To Video
WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104222_y5iz96kb.webp)
Wan 2.5 Text To Video Fast
WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104205_99s4gqxu.webp)
Wan 2.5 Image To Video Fast
WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104159_4c1hr4ym.webp)
Wan 2.5 Image To Video
WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Esempi
Wan 2.5 in azione
Output reali generati dall'API Wan 2.5. Passa il mouse su un video per l'anteprima, clicca per aprire il visualizzatore a schermo intero.
Guida
Come usare l'API Wan 2.5
Quattro passaggi dalla registrazione alla generazione completata. Esempi completi in Python, Node.js e cURL sono nella sezione API qui sotto.
- 01
Ottieni una chiave API
Registrati su WaveSpeedAI e copia la tua chiave API dalla dashboard. I nuovi account includono crediti gratuiti di benvenuto: bastano per usare il playground qualche decina di volte prima che inizi la fatturazione.
- 02
Invia una predizione
Invia con POST il tuo input in formato JSON a https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. L'endpoint restituisce subito un id di predizione: le generazioni sono asincrone, quindi non devi tenere una connessione aperta durante l'inferenza.
- 03
Controlla il completamento
Fai GET su https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Restituisci gli output con completed; interrompi con un errore con failed, cancelled, timeout o deleted; continua il polling per ogni altro stato.
- 04
Leggi l'URL dell'output
Quando lo stato è "completed", leggi l'URL da data.outputs[0]. L'URL punta al tuo contenuto generato sulla CDN di WaveSpeedAI: immagine, video, audio o file 3D a seconda della variante di Wan 2.5 che hai richiamato.
Casi d'uso
Cosa puoi creare con Wan 2.5
I flussi di lavoro più comuni per cui sviluppatori e creator usano l'API Wan 2.5.
Text-to-video con audio sincronizzato
alibaba/wan-2.5/text-to-video trasforma un prompt in una clip di 5 o 10 secondi fino a 1080p, con l'audio generato insieme all'immagine.
Image-to-video da uno still
alibaba/wan-2.5/image-to-video e la variante Fast animano un'immagine di riferimento con un prompt, a 720p o 1080p e da 3 a 10 secondi sull'endpoint Fast.
Estendi una clip
alibaba/wan-2.5/video-extend continua un video esistente con audio sincronizzato mantenuto o generato, a 480p, 720p o 1080p, e la variante Fast fa lo stesso a un costo inferiore.
Guida una clip con il tuo audio
Passa un file audio agli endpoint video per orientare la generazione, ad esempio una battuta parlata o un ritmo che il movimento deve seguire.
Modifica immagini nella stessa famiglia
alibaba/wan-2.5/image-edit applica modifiche guidate da prompt a una o due immagini, così still e clip provengono da un'unica famiglia di modelli.
Still con text-to-image
alibaba/wan-2.5/text-to-image genera immagini da un prompt, con dimensione impostata in pixel fino a 2880.
Consigli
Consigli per scrivere i prompt per Wan 2.5
Consigli pratici per ottenere output migliori da Wan 2.5, ricavati dagli schemi che funzionano con i modelli video nelle pipeline di produzione.
- 01
Prototipa su Fast, consegna sull'endpoint standard
Usa le varianti Fast per provare prompt e movimento, poi esegui l'endpoint standard per la clip finale.
- 02
Scegli la dimensione in base alla piattaforma
Il text-to-video offre formati orizzontali e verticali a 480p, 720p e 1080p: scegli la dimensione in base a dove verrà riprodotta la clip prima di generarla.
- 03
Usa l'audio per guidare i tempi
Un breve WAV o MP3 di almeno 3 secondi può guidare la generazione, utile quando il movimento deve seguire una battuta parlata o un ritmo.
- 04
Estendi a piccoli passi
Con video-extend, prosegui una clip pochi secondi alla volta e descrivi cosa succede dopo, così ogni passaggio mantiene coerenti scena e audio.
Prezzi
Prezzi dell'API Wan 2.5
Il prezzo è per output. L'addebito finale dipende dai parametri impostati nel playground di ciascuna variante (risoluzione, durata, numero di output, riferimenti).
| Endpoint | Tipo | Prezzo di partenza |
|---|---|---|
| alibaba/ | image-to-image | $0.035 |
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | video-extend | $0.068 |
| alibaba/ | video-extend | $0.10 |
| alibaba/ | text-to-video | $0.10 |
| alibaba/ | text-to-video | $0.068 |
| alibaba/ | image-to-video | $0.068 |
| alibaba/ | image-to-video | $0.10 |
API
Richiama l'API Wan 2.5
Ottieni una chiave API su wavespeed.ai/accesskey, poi invia una predizione tramite REST. Il playground genera esempi pronti da incollare per qualsiasi combinazione di input.
POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Confronto
Wan 2.5 a confronto con le alternative
Quando scegliere Wan 2.5 rispetto a modelli simili su WaveSpeedAI.
Wan 2.5 vs Wan 2.7
Wan 2.7 è la generazione più recente, con reference-to-video, video-edit e output 1080p su più endpoint. Wan 2.5 resta un'opzione con varianti Fast e audio sincronizzato.
Wan 2.5 vs Veo 3.1
Il catalogo presenta Wan 2.5 come più veloce e più economico di Google Veo 3, con generazione guidata dall'audio e video-extend. Veo 3.1 offre i livelli Standard, Fast e Lite a 1080p.
Wan 2.5 vs Kling 2.6
Kling 2.6 aggiunge il controllo del movimento e un endpoint create-voice. Wan 2.5 copre da 480p a 1080p con audio sincronizzato, video-extend, image-edit e text-to-image in un'unica famiglia.
FAQ
Wan 2.5 API — Domande frequenti
Prezzi, licenza, integrazione: le domande più comuni sull'uso di Wan 2.5 su WaveSpeedAI.
Quali risoluzioni supporta Wan 2.5?
Gli endpoint video producono output a 480p, 720p e 1080p a seconda dell'endpoint. Il text-to-video offre anche formati verticali, e l'image-to-video Fast produce 720p o 1080p.
Wan 2.5 genera l'audio?
Sì. Gli endpoint video producono audio sincronizzato con l'immagine, e puoi inviare un file audio opzionale per guidare il risultato.
Che cos'è Wan 2.5 Fast?
Sono le varianti Fast di text-to-video, image-to-video e video-extend, pensate per una generazione più veloce ed economica rispetto alle varianti standard.
Posso estendere un video esistente con Wan 2.5?
Sì. L'endpoint video-extend porta avanti una clip breve fino a una più lunga, con audio sincronizzato mantenuto o generato, e ha una variante Fast.
Che cos'è l'API Wan 2.5?
Wan 2.5 è un modello di generazione video di Alibaba reso disponibile come API REST su WaveSpeedAI. Alibaba Wan 2.5 — text-to-video e image-to-video fino a 1080p con audio sincronizzato, più video-extend, image-edit e text-to-image nella stessa famiglia, con varianti Fast degli endpoint video. Puoi richiamarlo da codice o provarlo dal playground collegato qui sopra.
Come richiamo l'API Wan 2.5?
Registrati su WaveSpeedAI, copia la tua chiave API da /accesskey, poi invia con POST a https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video il tuo input in formato JSON. L'endpoint restituisce un id di predizione. Fai polling sull'endpoint dei risultati circa ogni 2 secondi, aumenta l'intervallo per le attività di lunga durata e fermati a qualsiasi stato terminale. Gli esempi in Python / Node.js / cURL orientati alla produzione sono qui sopra.
Quanto costa l'API Wan 2.5?
Wan 2.5 parte da $0.03 per esecuzione. Il costo esatto dipende dai parametri impostati (risoluzione, durata, numero di output, riferimenti). L'anteprima del costo in tempo reale accanto al pulsante Genera nel playground mostra il prezzo esatto per il tuo input attuale.
Quali varianti di Wan 2.5 sono disponibili?
WaveSpeedAI offre 8 endpoint Wan 2.5 attivi: alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video. Ogni variante ha la sua pagina playground e i suoi prezzi.
Posso usare gli output di Wan 2.5 a fini commerciali?
I diritti di uso commerciale seguono la licenza del modello di Alibaba. La maggior parte dei modelli di Alibaba consente l'uso commerciale degli output; consulta la pagina playground di ciascun modello per il riepilogo della licenza e i Termini di servizio di WaveSpeedAI per le condizioni a livello di piattaforma.
Perché usare Wan 2.5 su WaveSpeedAI invece di rivolgersi direttamente al fornitore?
Una sola chiave API e un solo account di fatturazione per Wan 2.5 E per oltre 1.000 altri modelli AI di altri provider. Nessuna configurazione di SDK per fornitore, nessun limite di frequenza separato, nessun codice di integrazione da riscrivere per ogni fornitore. I prezzi sono in genere in linea o inferiori a quelli dell'API diretta di Alibaba.
Provider
Informazioni su Alibaba
Il team dietro Wan 2.5 e dietro l'intera gamma di modelli di Alibaba su WaveSpeedAI.
Il Tongyi Lab di Alibaba produce la famiglia di modelli video Wan e la famiglia di LLM Qwen. Wan si distingue per il rilascio con pesi aperti, un'ampia copertura di varianti (text-to-video, image-to-video, reference-to-video, video-edit, video-extend, image-edit, text-to-image) e una costante solidità in stabilità del movimento e aderenza al prompt con prompt multilingue.
Inizia a creare con Wan 2.5 su WaveSpeedAI
Crediti gratuiti di benvenuto alla registrazione. Una sola chiave API per oltre 1.000 modelli AI di Alibaba e di ogni altro provider.