Wan 2.5 API
Alibaba Wan 2.5 — teks-ke-video dan gambar-ke-video hingga 1080p dengan audio tersinkronisasi, plus video-extend, image-edit, dan text-to-image dalam keluarga yang sama, dengan varian Fast untuk endpoint video.
Panduan Wan 2.5 API ini membahas endpoint yang aktif di WaveSpeedAI: teks-ke-video, gambar-ke-video, dan video-extend dengan varian Fast, image-edit, dan text-to-image. Playground, contoh, harga, dan sampel API di bawah semuanya memakai endpoint Wan 2.5 yang aktif.
Ringkasan
Tentang Wan 2.5 API
Apa yang dilakukan Wan 2.5, posisinya dalam jajaran model Alibaba, dan mengapa banyak tim memilihnya.
Wan 2.5 adalah model pembuatan video dari Alibaba, tersedia melalui REST API WaveSpeedAI. Alibaba Wan 2.5 — teks-ke-video dan gambar-ke-video hingga 1080p dengan audio tersinkronisasi, plus video-extend, image-edit, dan text-to-image dalam keluarga yang sama, dengan varian Fast untuk endpoint video.
Panduan Wan 2.5 API ini membahas endpoint yang aktif di WaveSpeedAI: teks-ke-video, gambar-ke-video, dan video-extend dengan varian Fast, image-edit, dan text-to-image. Playground, contoh, harga, dan sampel API di bawah semuanya memakai endpoint Wan 2.5 yang aktif.
Keluarga Wan 2.5 di WaveSpeedAI menyediakan 8 endpoint REST yang mencakup alur kerja Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Setiap varian memiliki harga, parameter, dan contoh output sendiri — pilih yang sesuai dengan modalitas input dan kebutuhan produksi Anda, atau panggil beberapa sekaligus dengan satu API key untuk menyusun pipeline multi-langkah.
Jalankan Wan 2.5 dengan API key, akun penagihan, dan batas laju yang sama dengan yang Anda pakai untuk 1.000+ model AI lainnya di WaveSpeedAI. Tanpa penyiapan vendor terpisah, tanpa SDK per penyedia, tanpa batas laju per vendor — satu integrasi mencakup semuanya, dari text-to-image dan text-to-video hingga sintesis audio, pembuatan 3D, upscaling, dan pengeditan.
Spesifikasi
Kemampuan dan status rilis Wan 2.5 API
Detail khusus model yang dicari pengembang sebelum memilih API: ketersediaan, perkiraan panjang output, dukungan referensi, dan alternatif aktif saat ini.
Ketersediaan
Sudah aktif
Endpoint Wan 2.5 sudah aktif di katalog WaveSpeedAI: teks-ke-video, gambar-ke-video, dan video-extend (masing-masing dengan varian Fast), image-edit, dan text-to-image, semuanya dalam alur prediksi REST yang sama.
Resolusi
480p, 720p, 1080p
Output video tersedia pada 480p, 720p, dan 1080p tergantung endpoint; teks-ke-video menawarkan ukuran lanskap dan potret di setiap resolusi.
Durasi
3 hingga 10 detik
Teks-ke-video menghasilkan klip 5 atau 10 detik; gambar-ke-video Fast dan video-extend menghasilkan 3 hingga 10 detik.
Audio
Audio tersinkronisasi
Endpoint video menghasilkan audio yang tersinkronisasi dengan gambar, dan file audio opsional (WAV atau MP3, minimal 3 detik, hingga 15 MB) dapat memandu generasi.
Varian Fast
Teks, gambar, dan extend
Wan 2.5 Fast tersedia untuk teks-ke-video, gambar-ke-video, dan video-extend, diposisikan untuk generasi yang lebih cepat dan lebih terjangkau.
Alat gambar
Edit dan text-to-image
image-edit menerima hingga dua gambar input dengan prompt, dan text-to-image membuat gambar diam dalam keluarga yang sama dengan endpoint video.
Endpoint
Semua endpoint API Wan 2.5
8 endpoint Wan 2.5 tersedia sekarang di WaveSpeedAI — pilih varian yang sesuai dengan alur kerja Anda.
/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.
Contoh
Lihat Wan 2.5 beraksi
Output nyata yang dihasilkan oleh API Wan 2.5. Arahkan kursor ke video mana pun untuk pratinjau, klik untuk membuka penampil ukuran penuh.
Cara pakai
Cara menggunakan API Wan 2.5
Empat langkah dari pendaftaran hingga hasil jadi. Contoh lengkap Python, Node.js, dan cURL ada di bagian API di bawah.
- 01
Dapatkan API key
Daftar akun WaveSpeedAI dan salin API key Anda dari dasbor. Akun baru mendapat kredit awal gratis — cukup untuk menjalankan playground beberapa puluh kali sebelum penagihan dimulai.
- 02
Kirim prediksi
POST input Anda sebagai JSON ke https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. Endpoint langsung mengembalikan id prediksi — proses generasi bersifat asinkron sehingga Anda tidak perlu menahan koneksi terbuka selama inferensi.
- 03
Polling hingga selesai
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Ambil output saat completed; hentikan dengan error saat failed, cancelled, timeout, atau deleted; lanjutkan polling untuk status lainnya.
- 04
Baca URL output
Setelah status "completed", baca URL dari data.outputs[0]. URL tersebut mengarah ke media hasil generasi Anda di CDN WaveSpeedAI — file gambar, video, audio, atau 3D tergantung varian Wan 2.5 yang Anda panggil.
Kasus penggunaan
Apa yang bisa Anda bangun dengan Wan 2.5
Alur kerja umum yang dipakai pengembang dan kreator dengan API Wan 2.5.
Teks-ke-video dengan audio tersinkronisasi
alibaba/wan-2.5/text-to-video mengubah prompt menjadi klip 5 atau 10 detik hingga 1080p dengan audio yang dibuat bersamaan dengan gambar.
Gambar-ke-video dari gambar diam
alibaba/wan-2.5/image-to-video dan varian Fast menganimasikan gambar referensi dengan prompt, pada 720p atau 1080p dan 3 hingga 10 detik di endpoint Fast.
Perpanjang klip
alibaba/wan-2.5/video-extend melanjutkan video yang ada dengan audio tersinkronisasi yang dipertahankan atau dibuat baru, pada 480p, 720p, atau 1080p, dan varian Fast melakukan hal yang sama dengan biaya lebih rendah.
Arahkan klip dengan audio Anda sendiri
Kirim file audio ke endpoint video untuk membentuk hasil generasi, misalnya satu baris suara atau irama yang harus diikuti gerakan.
Sunting gambar dalam keluarga yang sama
alibaba/wan-2.5/image-edit menerapkan penyuntingan berbasis prompt pada satu atau dua gambar, sehingga gambar diam dan klip berasal dari satu keluarga model.
Gambar diam dengan text-to-image
alibaba/wan-2.5/text-to-image menghasilkan gambar dari prompt, dengan ukuran diatur dalam piksel hingga 2880.
Tips
Tips menulis prompt untuk Wan 2.5
Saran praktis untuk mendapatkan output yang lebih baik dari Wan 2.5 — diambil dari pola yang berhasil pada model video di pipeline produksi.
- 01
Buat prototipe di Fast, serahkan hasil di endpoint standar
Gunakan varian Fast untuk menguji prompt dan gerakan, lalu jalankan endpoint standar untuk klip akhir.
- 02
Pilih ukuran sesuai platform
Teks-ke-video menawarkan ukuran lanskap dan potret pada 480p, 720p, dan 1080p, jadi pilih ukuran sesuai tempat klip akan diputar sebelum membuatnya.
- 03
Gunakan audio untuk mengarahkan waktu
WAV atau MP3 singkat berdurasi minimal 3 detik dapat memandu generasi, yang berguna saat gerakan harus mengikuti satu baris suara atau irama.
- 04
Perpanjang sedikit demi sedikit
Dengan video-extend, lanjutkan klip beberapa detik sekali dan jelaskan apa yang terjadi berikutnya, agar setiap langkah menjaga adegan dan audio tetap berkesinambungan.
Harga
Harga API Wan 2.5
Harga dihitung per output. Biaya akhir menyesuaikan parameter yang Anda atur di playground setiap varian (resolusi, durasi, jumlah output, referensi).
| Endpoint | Jenis | Harga mulai dari |
|---|---|---|
| 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
Panggil API Wan 2.5
Daftar untuk mendapatkan API key di wavespeed.ai/accesskey, lalu kirim prediksi melalui REST. Playground menghasilkan contoh siap tempel untuk kombinasi input apa pun.
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)Perbandingan
Wan 2.5 vs alternatif
Kapan memilih Wan 2.5 dibanding model serupa di WaveSpeedAI.
Wan 2.5 vs Wan 2.7
Wan 2.7 adalah generasi yang lebih baru dengan reference-to-video, video-edit, dan output 1080p di lebih banyak endpoint. Wan 2.5 tetap menjadi pilihan dengan varian Fast dan audio tersinkronisasi.
Wan 2.5 vs Veo 3.1
Katalog memosisikan Wan 2.5 lebih cepat dan lebih terjangkau daripada Google Veo 3, dengan generasi berpemandu audio dan video-extend. Veo 3.1 menawarkan tingkat Standard, Fast, dan Lite pada 1080p.
Wan 2.5 vs Kling 2.6
Kling 2.6 menambahkan motion control dan endpoint create-voice. Wan 2.5 mencakup 480p hingga 1080p dengan audio tersinkronisasi, video-extend, image-edit, dan text-to-image dalam satu keluarga.
FAQ
Wan 2.5 API — Pertanyaan yang sering diajukan
Harga, lisensi, integrasi — pertanyaan umum tentang menjalankan Wan 2.5 di WaveSpeedAI.
Resolusi apa saja yang didukung Wan 2.5?
Endpoint video menghasilkan output 480p, 720p, dan 1080p tergantung endpoint. Teks-ke-video juga menawarkan ukuran potret, dan gambar-ke-video Fast menghasilkan 720p atau 1080p.
Apakah Wan 2.5 menghasilkan audio?
Ya. Endpoint video menghasilkan audio yang tersinkronisasi dengan gambar, dan Anda dapat mengirim file audio opsional untuk memandu hasilnya.
Apa itu Wan 2.5 Fast?
Varian Fast dari teks-ke-video, gambar-ke-video, dan video-extend, diposisikan untuk generasi yang lebih cepat dan lebih terjangkau daripada varian standar.
Bisakah saya memperpanjang video yang ada dengan Wan 2.5?
Bisa. Endpoint video-extend melanjutkan klip pendek menjadi lebih panjang, dengan audio tersinkronisasi yang dipertahankan atau dibuat baru, dan memiliki varian Fast.
Apa itu API Wan 2.5?
Wan 2.5 adalah model pembuatan video dari Alibaba yang tersedia sebagai REST API di WaveSpeedAI. Alibaba Wan 2.5 — teks-ke-video dan gambar-ke-video hingga 1080p dengan audio tersinkronisasi, plus video-extend, image-edit, dan text-to-image dalam keluarga yang sama, dengan varian Fast untuk endpoint video. Anda dapat memanggilnya secara terprogram atau mencobanya dari playground yang ditautkan di atas.
Bagaimana cara memanggil API Wan 2.5?
Daftar akun WaveSpeedAI, salin API key Anda dari /accesskey, lalu POST ke https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video dengan input Anda sebagai JSON. Endpoint mengembalikan id prediksi. Lakukan polling pada endpoint hasil dengan interval sekitar 2 detik, perpanjang interval untuk tugas yang berjalan lama, dan berhenti pada status akhir apa pun. Contoh Python / Node.js / cURL untuk produksi ada di atas.
Berapa biaya API Wan 2.5?
Wan 2.5 mulai dari $0.03 per run. Biaya pastinya menyesuaikan parameter yang Anda atur (resolusi, durasi, jumlah output, referensi). Pratinjau biaya langsung di samping tombol Generate di playground menampilkan harga pasti untuk input Anda saat ini.
Varian Wan 2.5 apa saja yang tersedia?
WaveSpeedAI menyediakan 8 endpoint Wan 2.5 aktif: 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. Setiap varian memiliki halaman playground dan harga sendiri.
Bisakah output Wan 2.5 dipakai secara komersial?
Hak penggunaan komersial mengikuti lisensi model Alibaba. Sebagian besar model Alibaba mengizinkan penggunaan output secara komersial; lihat halaman playground tiap model untuk ringkasan lisensinya, dan Ketentuan Layanan WaveSpeedAI untuk ketentuan tingkat platform.
Mengapa memakai Wan 2.5 di WaveSpeedAI dan bukan langsung?
Satu API key + satu akun penagihan untuk Wan 2.5 DAN 1.000+ model AI lain dari penyedia lain. Tanpa penyiapan SDK per vendor, tanpa batas laju terpisah, tanpa menulis ulang kode integrasi untuk tiap vendor. Harganya umumnya setara atau di bawah API langsung dari Alibaba.
Penyedia
Tentang Alibaba
Tim di balik Wan 2.5 dan jajaran model Alibaba lainnya di WaveSpeedAI.
Tongyi Lab milik Alibaba menghasilkan keluarga model video Wan dan keluarga LLM Qwen. Wan menonjol karena dirilis dengan open weights, cakupan varian yang luas (teks-ke-video, gambar-ke-video, referensi-ke-video, video-edit, video-extend, image-edit, teks-ke-gambar), dan kekuatan yang konsisten pada stabilitas gerakan dan kepatuhan prompt di berbagai prompt multibahasa.
Mulai membangun dengan Wan 2.5 di WaveSpeedAI
Kredit awal gratis saat mendaftar. Satu API key untuk 1.000+ model AI dari Alibaba dan semua penyedia lainnya.