Model teks-ke-video Wan menghasilkan video dari input teks, gambar, dan audio. Model wan3.0-video mendukung durasi hingga 30 detik, rasio aspek adaptif, durasi cerdas, resolusi 480P/720P/1080P, toggle audio, audio referensi, serta file dan tautan web referensi.
Akses cepat: Coba secara online (Singapura | AS (Virginia) | Tiongkok (Beijing)) | Referensi API | Panduan prompt
Sebelum melakukan panggilan API, dapatkan Kunci API dan tetapkan sebagai Variabel lingkungan. Untuk menggunakan SDK, instal SDK DashScope. Semua contoh menggunakan pemanggilan asinkron yang mengirimkan tugas pembuatan video dan melakukan polling untuk hasilnya.
Contoh output
Model yang didukung berbeda-beda berdasarkan wilayah. Sumber daya diisolasi antar wilayah. Saat melakukan panggilan, pastikan model, URL titik akhir, dan Kunci API Anda semuanya berasal dari wilayah yang sama. Panggilan lintas wilayah akan gagal.
Model yang didukung:
Model yang didukung:
Model yang didukung:
Model yang didukung:
Referensi API text-to-video
Mulai
| Masukkan prompt | Video output (multi-shot, audio aktif) |
| Shot 1 Adegan dibuka dengan extreme long shot. Kamera mulai dari sudut rendah dekat tanah dan bergerak maju melintasi padang rumput sambil miring ke atas. Saat kamera naik dari permukaan tanah ke posisi yang sedikit lebih tinggi, cheetah masuk ke dalam frame dari kiri. Shot ini menetapkan hubungan spasial yang jelas dengan menempatkan cheetah dan antelope yang sedang kabur pada jalur yang sama. Shot 2 Kamera turun ke posisi dekat permukaan tanah dan mengikuti ke kanan, sejajar dengan cheetah. Cheetah dipertahankan konsisten di sebelah kiri tengah frame, menciptakan pergeseran lateral berkelanjutan pada latar belakang. Untuk periode tertentu, gerakan kamera tetap stabil untuk meningkatkan rasa kecepatan dan kontinuitas spasial. Shot 3 Sambil tetap bergerak ke kanan, kamera melakukan gerakan busur ringan di sepanjang bagian dalam jalur cheetah. Gerakan ini menciptakan efek orbit halus dalam frame saat kamera terus mengikuti subjek. Shot 4 Kamera secara bertahap memperlambat gerakan lateralnya dan menjadi relatif stabil sambil melakukan zoom in. Aksi ini mempersempit fokus ke jarak yang semakin mengecil antara cheetah dan antelope. Shot 5 Kamera kembali bergerak maju dan sedikit ke bawah, menempel dekat tanah untuk memperpendek jarak antara kedua hewan tersebut. Shot berhenti pada titik kritis tepat saat kaki depan cheetah hampir menyentuh pantat antelope, menciptakan tekanan dan ketegangan yang intens. Aksi ini disinkronkan dengan alunan musik simfoni yang meningkat, dentuman drum yang semakin rapat, serta suara angin dan langkah kaki yang mendorong ritme. Pada momen terakhir, volume musik turun, hanya menyisakan suara ambient dan ritmis untuk menciptakan jeda singkat. |
- Python SDK
- Java SDK
- curl
Kode contoh: model wan2.6 dan versi sebelumnya
Kode contoh: model wan2.6 dan versi sebelumnya
- Python SDK
- Java SDK
- curl
video_url berlaku selama 24 jam. Unduh video segera.
Ketersediaan
Model yang didukung berbeda-beda berdasarkan wilayah. Sumber daya diisolasi antar wilayah. Saat melakukan panggilan, pastikan model, URL titik akhir, dan Kunci API Anda semuanya berasal dari wilayah yang sama. Panggilan lintas wilayah akan gagal.
Model yang didukung:
- Global
- Internasional
- AS
- Tiongkok daratan
Jika Anda memilih cakupan Global, sumber daya komputasi inferensi model dijadwalkan secara dinamis di seluruh dunia. Data statis disimpan di wilayah yang Anda pilih. Wilayah yang didukung: AS (Virginia), Jerman (Frankfurt)Tiongkok (Hong Kong).
Model | Fitur | Modalitas input | Spesifikasi video output |
|---|---|---|---|
wan2.6-t2v | Video dengan audio Narasi multi-shot, sinkronisasi audio-video | Teks, audio | Opsi resolusi: 720P, 1080P Durasi video: 5s, 10s, 15s Spesifikasi tetap: 30 fps, MP4 (encoding H.264) |
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.
Kemampuan inti
Buat video multi-shot
Model yang didukung: seri wan3.0, wan2.7, dan wan2.6.
Deskripsi: Secara otomatis beralih antar shot — misalnya, dari wide shot ke close-up. Ideal untuk video musik dan narasi sinematik.
Parameter:
- wan2.7: Parameter
shot_typetidak diperlukan. Jelaskan struktur shot dalampromptmenggunakan bahasa alami, seperti stempel waktu untuk menentukan shot. Jikaprompttidak berisi deskripsi struktur shot, model menganalisis semantik dan secara otomatis menentukan apakah akan menghasilkan video single-shot atau multi-shot. - wan2.6: Parameter
shot_typeharus diatur ke"multi", dan parameterprompt_extendharus diatur ketrueuntuk mengaktifkan penulisan ulang cerdas guna mengoptimalkan deskripsi shot.
| Input prompt | Video keluaran (wan3.0) |
| Visi harmoni antara teknologi masa depan dan alam. Shot 1 [0-2s]: Wide shot taman udara di kota futuristik, tanaman mengambang bergoyang lembut ditiup angin. Shot 2 [2-4s]: Tukang kebun robot dengan hati-hati memangkas tanaman dengan gerakan yang presisi dan anggun. Shot 3 [4-7s]: Sinar matahari menembus kubah transparan, menerangi seluruh taman dan menampilkan fusi sempurna antara teknologi dan alam. Shot 4 [7-10s]: Kamera mundur untuk mengungkap skala megah seluruh kota futuristik, dengan taman udara sebagai salah satu bagiannya. | |
| Ini adalah cuplikan film seni bela diri yang berpusat pada duel keras. Di area batu terbuka di bawah terik matahari siang, dua pria saling menyerbu. Salah satu menyerang dengan telapak tangannya, tetapi lawannya berputar dan memblokir dengan lengannya, benturan tersebut mengangkat debu dari tanah. Mereka kemudian saling bertukar pukulan dan serangan telapak tangan dengan cepat dalam ruang sempit. Salah satu melompat ke udara untuk melakukan serangkaian tendangan keras, memaksa lawannya menyilangkan lengannya untuk memblokir dan tergelincir mundur beberapa meter, meninggalkan bekas putih yang jelas di permukaan batu. Akhirnya, mereka berdiri terpisah, bernapas berat dan saling menatap mata. Adegan ini menghadirkan tekstur aksi realistis dengan pencahayaan tajam, menciptakan nada yang berubah dari ledakan kuat menjadi ketegangan yang menegangkan. |
- Python SDK
- Java SDK
- curl
Pastikan SDK DashScope untuk Python Anda versi 1.25.16 atau lebih baru. Untuk memperbarui SDK, lihat Instal SDK.
Kode contoh: wan2.6
Kode contoh: wan2.6
- Python SDK
- Java SDK
- curl
Pastikan SDK DashScope untuk Python Anda versi 1.25.16 atau lebih baru. Untuk memperbarui SDK, lihat Instal SDK.
Sinkronkan audio dan video
Model yang didukung: seri wan3.0, wan2.7, wan2.6, dan wan2.5.
Deskripsi: Karakter dalam video dapat "berbicara" atau bernyanyi dengan gerakan mulut yang disesuaikan dengan audio. Untuk contoh lainnya, lihat Pembuatan video audio.
Parameter:
- Sediakan file audio: Atur
audio_url. Model akan menyinkronkan gerakan mulut dengan file audio tersebut. - Dubbing otomatis: Tanpa
audio_url, model secara otomatis menghasilkan video dengan audio default—menambahkan efek suara latar, musik, atau suara berdasarkan konten visual.
| Contoh input | Video output (video dengan audio) |
| Prompt input: Diambil dari sudut rendah, dalam medium close-up, dengan nada hangat, pencahayaan campuran (cahaya praktis dari lampu meja menyatu dengan cahaya mendung dari jendela), pencahayaan samping, dan komposisi sentral. Di kantor detektif klasik, rak buku kayu dipenuhi berkas kasus lama dan asbak. Lampu meja hijau menerangi berkas kasus yang tersebar di tengah meja. Seekor rubah, mengenakan jas hujan coklat tua dan fedora abu-abu muda, duduk di kursi kulit, bulunya merah tua, ekornya bertumpu ringan di tepi, jarinya perlahan membalik halaman-halaman yang menguning. Di luar, hujan gerimis turun di bawah langit biru, menggores kaca dengan garis-garis berkelok. Perlahan mengangkat kepalanya, telinganya bergerak sedikit, matanya yang kuning menatap langsung ke kamera, mulutnya bergerak jelas saat berbicara dengan suara halus dan sinis: 'Kasus ini sudah dingin, lebih dingin dari ikan di musim dingin. Tapi setiap ayam punya rahasia, dan saya, untuk satu hal, berniat menemukannya '.Audio input: |
- Python SDK
- Java SDK
- curl
Pastikan SDK DashScope untuk Python Anda versi 1.25.16 atau lebih baru. Untuk memperbarui SDK, lihat Instal SDK.
Kode contoh: wan2.6
Kode contoh: wan2.6
- Python SDK
- Java SDK
- curl
Pastikan SDK DashScope untuk Python Anda versi 1.25.16 atau lebih baru. Untuk memperbarui SDK, lihat Instal SDK.
Buat video tanpa suara
Model yang didukung: seri wan2.2, , seri wan2.1.
Deskripsi: Paling cocok untuk skenario yang hanya memerlukan konten visual, seperti poster dinamis dan video pendek tanpa suara.
Parameter: Model wan2.2 dan versi sebelumnya menghasilkan video tanpa suara secara default—tidak diperlukan konfigurasi tambahan.
| Prompt masukan | Video output (video tanpa suara) |
| Rim light, kontras rendah, medium close-up, siang hari, komposisi condong ke kiri, shot orang tunggal yang bersih, nada hangat, cahaya lembut, cahaya siang yang cerah, cahaya samping, siang hari. Seorang gadis muda duduk di ladang rumput tinggi dengan dua keledai berbulu lembut berdiri di belakangnya. Gadis itu, sekitar sebelas atau dua belas tahun, mengenakan gaun bunga sederhana, rambutnya dikepang dua, dan memiliki senyum polos. Ia duduk bersila, dengan lembut menyentuh bunga liar di sampingnya. Keledai-keledai itu kokoh, telinga mereka tegak, dengan rasa ingin tahu melihat ke arah kamera. Sinar matahari memandikan ladang tersebut, menciptakan adegan yang hangat dan alami. |
- Python SDK
- Java SDK
- curl
Pastikan SDK DashScope untuk Python Anda menggunakan versi 1.25.16 atau lebih baru. Untuk memperbarui SDK, lihat Instal SDK.
Input audio
- Jumlah file: Satu.
-
Metode input:
- URL publik: HTTP atau HTTPS.
Video output
- Jumlah video: Satu.
- Format: MP4. Untuk informasi selengkapnya, lihat Spesifikasi video.
- Kedaluwarsa URL: 24 jam.
-
Dimensi video:
- Model wan3.0 dan wan2.7 menggunakan parameter
resolutiondanratio. - Model wan2.6 dan versi sebelumnya menggunakan parameter
size.
- Model wan3.0 dan wan2.7 menggunakan parameter
Penagihan dan pembatasan laju
- Untuk detail kuota gratis dan harga, lihat Wanx-Text-to-Video.
- Untuk pembatasan laju model, lihat Seri Wanxiang.
-
Detail penagihan:
- Input gratis. Output ditagih per detik video yang berhasil dihasilkan.
- Panggilan model yang gagal atau kesalahan pemrosesan tidak dikenai biaya dan tidak mengonsumsi kuota gratis.
- Text-to-video juga mendukung rencana penghematan.
Referensi API
Referensi API text-to-video
FAQ
T: Perubahan kode apa yang diperlukan untuk meningkatkan dari wan2.7 ke wan3.0?
- Nama model: Ubah
modeldariwan2.7-t2v-*kewan3.0-video. - Hapus prompt_extend: wan3.0 tidak mendukung parameter
prompt_extend. Hapus field ini. - Durasi diperpanjang: wan3.0 mendukung durasi hingga 30 detik (sedangkan wan2.7 hanya hingga 15 detik). Atur
durationke bilangan bulat antara 2 dan 30. - Input file dan web baru: wan3.0 mendukung penggunaan
type: "file"(docx, ppt, pdf, dll.) atautype: "link"(URL web publik) dalaminput.media. Model secara otomatis memahami konten dan menghasilkan video. Kedua jenis input ini tidak dapat digunakan secara bersamaan.
T: Video yang dihasilkan di konsol memiliki Watermark. Bagaimana cara menghapusnya?
- Halaman pembuatan video di konsol Model Studio tidak menyediakan opsi untuk menonaktifkan Watermark, sehingga Anda tidak dapat menghapus Watermark melalui konsol.
- Saat memanggil model melalui API, nilai default
watermarkadalahfalse: jika parameter ini tidak disertakan atau diatur kefalse, Watermark tidak ditambahkan. Kode contoh dalam topik ini menggunakanwatermark=true; ubah nilainya menjadifalseuntuk menghapus Watermark.
T: Saya membeli rencana penghematan AI umum. Mengapa video yang dihasilkan masih memiliki Watermark?
- Rencana penghematan AI umum hanya mengimbangi biaya penggunaan. Rencana ini tidak memengaruhi output model dan tidak terkait dengan keberadaan Watermark pada video.
- Watermark dikontrol sepenuhnya oleh parameter API
watermarkdan hanya ditambahkan jika Anda secara eksplisit mengirimkan nilaitrue.