Wan API

Delapan model video, satu API key

Empat varian Wan — 3.0, 3.0 Prime, 3.0 Pro, dan 3.0 Prime Pro — berdampingan dengan Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast, dan Seedance 2.0 Mini dalam satu platform. GET /v1/models menampilkan model yang bisa diakses key saat ini, dan tiap model punya ID terdokumentasi sendiri, misalnya wan3.0-video atau w3.0-video-prime-pro.

Mode input multimodal

Permintaan bisa berisi prompt teks saja, frame pertama atau terakhir, atau kumpulan referensi: maksimal 10 gambar, 5 klip video, dan 5 klip audio, ditambah satu dokumen atau halaman web publik. Mode keyframe dan mode referensi terpisah dan tidak dicampur dalam satu permintaan; prompt dibatasi 20.000 karakter.

Playground dengan pratinjau request native

Setiap halaman model menyematkan Playground yang menyusun body request native datar untuk model terpilih, mengabaikan kolom opsional yang kosong, dan memeriksa ketersediaan generasi sebelum pengiriman. Playground memakai sesi situs serta saldo prabayar yang sama, jadi key tidak perlu ditempel ke browser.

API task asinkron

Pengiriman ke endpoint model langsung mengembalikan ID task publik; statusnya pending, processing, completed, atau failed, dan respons yang selesai memuat URL Bunny CDN bertanda tangan yang bisa diputar atau diunduh tanpa header Authorization. POST /v1/responses mendukung tunggu sinkron, mode latar belakang, atau server-sent events.

Tarif diatur lewat level moderasi

Kolom opsional nsfw_checker memilih moderasi ketat atau lebih longgar pada Wan 3.0 dan Wan 3.0 Prime, dan masing-masing nilai punya tarif per detik sendiri. Varian Pro hanya menerima false. Kiriman yang ditolak moderasi dapat diajukan ulang dengan nilai lain sambil mempertahankan ID model publik yang sama.

Cek saldo dan penghapusan task

GET /v1/balance mengembalikan saldo akun yang bisa dipakai serta sisa limit pada key yang memanggil. DELETE /v1/tasks/{task_id} menghapus satu task yang sudah selesai beserta berkas video dan frame terakhir yang tersimpan. Teks situs juga dirilis dalam format yang bisa dibaca mesin di /llms.txt dan /llms-full.txt.

• Tim produk dan e-commerce: ubah foto diam satu produk menjadi reveal lambat atau orbit kamera, lalu periksa bentuk, pantulan, dan label sebelum klip dipakai di kampanye.
• Naskah, storyboard, dan sosial: saat belum ada pengambilan gambar atau key art, ubah adegan tertulis jadi pratinjau bergerak dan nilai pencahayaan, arah kamera, serta tempo lewat klip pendek.
• Agensi yang bekerja dari brief: masukkan dokumen ringkas atau halaman publik agar ide tertulis menjadi titik awal visual dengan satu audiens dan satu pesan.
• Tim engineering yang mengintegrasikan video: bandingkan tarif, durasi, dan jatah referensi Wan dan Seedance berdampingan, lalu pakai model terpilih dengan satu key dan satu saldo.
• Kerja karakter berbasis referensi: tetapkan peran untuk tiap aset yang diunggah — penampilan, gerakan, suara — supaya scene Seedance 2.5 yang lebih panjang tetap mudah dibaca karakter dan lokasinya.

Apakah ini layanan resmi Alibaba atau ByteDance?

Bukan. Wan API berjalan mandiri di wanapi.app, tanpa afiliasi atau dukungan dari Alibaba, Wan, atau ByteDance; nama-nama itu menyebut model pihak ketiga yang disediakan, dan mereknya milik masing-masing pemilik.

Perlukah langganan untuk membuat video?

Tidak ada paket video bulanan yang ditawarkan. Akses bergantung pada akun aktif dengan saldo, dan biayanya tarif resolusi dikali detik terhitung.

Detik mana yang ditagih?

Detik video referensi ditambah detik keluaran yang dihasilkan. Teks, gambar, dan audio tidak menambah detik, dan mematikan audio hasil generasi tidak menurunkan tarif.

Bisakah task dibatalkan atau dikirim ulang otomatis?

Pembatalan, webhook, dan idempotency key tidak diiklankan, dan pengiriman tidak diulang atau dipindah model secara otomatis. Setelah timeout atau tanpa ID, query dulu task yang ada karena POST ulang bisa membuat task berbayar kedua.

Berapa lama video hasil tetap tersedia?

Task yang selesai mengembalikan URL CDN bertanda tangan tanpa perlu key, tetapi berkas mengikuti kebijakan retensi platform. Polling tidak memperpanjang masa tersedia, jadi simpan salinan sendiri.

Model mana untuk uji pertama?

Wan 3.0 mencakup 480p sampai 1080p dengan tarif paling rendah; Prime model terpisah dengan harga sendiri; hanya varian Pro yang mencapai 2K dan 4K. Tiap halaman Seedance punya batas durasi dan referensi sendiri, jadi pilih sesuai kebutuhan hasil dan jangan mengandaikan resolusi tinggi pada model murah.

Bisakah body request dipakai ulang antar model?

Empat model Wan berbagi 14 field generasi native, tetapi nilai resolusi, ID model, dan dukungan nsfw_checker berbeda — varian Pro hanya menerima nilai yang lebih longgar. Field tak dikenal ditolak, jadi periksa dulu halaman model tujuan.

• Masuk ke wanapi.app dengan Google dan isi dana di pengaturan akun; akun situs saja belum membuka akses generasi.
• Buat key di API key settings dan simpan hanya di sisi server; Playground memakai sesi situs serta saldo yang sama.
• Pilih model dari ikhtisar atau lewat GET /v1/models, lalu buka halaman modelnya untuk cek resolusi, rentang durasi, dan batas referensi.
• Susun permintaan di Playground model tersebut dan salin body native hasil pratinjau, atau tulis JSON sendiri memakai ID model terdokumentasi.
• Setelah mengirim, langsung simpan ID task yang dikembalikan dan mulai polling dari jeda lima detik, perpanjang jeda saat ada error sementara.
• Putar atau unduh lewat URL bertanda tangan pada respons yang selesai, lalu salin berkas ke storage sendiri sebelum masa retensi habis.