Model text-to-video Wan menghasilkan video yang mulus dari text prompt .
Referensi: Panduan pengguna
Sesuaikan wilayah model, URL endpoint, dan Kunci API Anda. Panggilan lintas-wilayah akan gagal.
Tugas text-to-video memerlukan waktu 1–5 menit. API menggunakan pemanggilan asinkron: Buat tugas → Poll hasilnya.
Ganti
Ganti
Tugas text-to-video memerlukan waktu 1–5 menit, sehingga API menggunakan pemanggilan asinkron: Buat tugas → Poll hasilnya.
Ganti
Ganti
Nama parameter SDK sebagian besar sesuai dengan API HTTP, dengan struktur mengikuti konvensi khusus bahasa.
Tugas text-to-video memerlukan waktu 1–5 menit. SDK membungkus alur panggilan HTTP asinkron dan mendukung pemanggilan sinkron maupun asinkron.
Atur dashscope.base_http_api_url ke endpoint wilayah:
Ganti
Atur Constants.baseHttpApiUrl ke endpoint wilayah:
Ganti
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk penyelesaian.
A: Diperlukan dua perubahan:
A: Konversi langsung tidak dimungkinkan. Unduh video dari URL tersebut, lalu unggah ke penyimpanan persisten (seperti Alibaba Cloud OSS) untuk menghasilkan tautan permanen.
A: Tidak. Tautan tersebut kedaluwarsa setelah 24 jam. Unduh video, simpan secara persisten, dan gunakan tautan permanen untuk pemutaran.
Ketersediaan
Sesuaikan wilayah model, URL endpoint, dan Kunci API Anda. Panggilan lintas-wilayah akan gagal.
- Pilih model: Buka Model Square untuk memilih model dan memverifikasi wilayahnya.
- Pilih URL: Gunakan URL endpoint sesuai wilayah tersebut. Protokol HTTP dan HTTPS keduanya didukung.
- Konfigurasikan Kunci API: Pilih wilayah, dapatkan Kunci API, dan konfigurasikan dalam Variabel lingkungan.
- Instal SDK: Untuk memanggil API melalui SDK, instal SDK DashScope.
Kode contoh dalam topik ini menggunakan wilayah Singapura.
HTTP (wan2.7)
Tugas text-to-video memerlukan waktu 1–5 menit. API menggunakan pemanggilan asinkron: Buat tugas → Poll hasilnya.
Langkah 1: Buat tugas
- Beijing
- Singapura
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Singapura
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk menanyakan hasilnya.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.
Parameter permintaan |
Kendalikan struktur shot dengan bahasa alami dalam prompt. Parameter shot_type tidak berpengaruh.
| ||||||||||||||||||||||||
Header | |||||||||||||||||||||||||
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json. | |||||||||||||||||||||||||
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |||||||||||||||||||||||||
X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus enable. | |||||||||||||||||||||||||
Body permintaan | |||||||||||||||||||||||||
model string (Wajib)Nama model. Untuk daftar model dan harga, lihat Harga model.Contoh: wan2.7-t2v, wan2.7-t2v-2026-06-12. | |||||||||||||||||||||||||
input object (Wajib)Data input, termasuk prompt.
Properti prompt string (Wajib)Text prompt yang menjelaskan konten dan gaya visual video.Mendukung bahasa Tiongkok dan Inggris. Setiap karakter atau huruf dihitung sebagai satu. Teks yang melebihi batas akan dipotong secara otomatis. Panjang maksimum berdasarkan model:
string (Opsional)Elemen yang ingin dikecualikan dari video yang dihasilkan.Mendukung bahasa Tiongkok dan Inggris. Maksimal 500 karakter; teks yang lebih panjang akan dipotong secara otomatis.Contoh: low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions.audio_url string (Opsional)URL file audio untuk pembuatan video.Format yang didukung:
| |||||||||||||||||||||||||
parameters object (Opsional)Parameter pembuatan video: resolusi, penulisan ulang prompt, dan watermark.
Properti resolution string (Opsional)Tingkat resolusi video yang dihasilkan. Mengontrol kejernihan output (jumlah total piksel).
string (Opsional)Rasio aspek video output.
integer (Opsional)Durasi video output, dalam detik.
boolean (Opsional)Mengaktifkan penulisan ulang prompt. Saat diaktifkan, LLM menulis ulang prompt input untuk meningkatkan kualitas generasi. Paling baik untuk prompt pendek tetapi menambah latensi.
boolean (Opsional)Menambahkan watermark di pojok kanan bawah dengan teks "AI Generated".
integer (Opsional)Bilangan acak seed harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dihasilkan. Seed tetap meningkatkan reproduktibilitas.Karena generasi model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
Parameter respons |
Simpan task_id untuk menanyakan status dan hasil tugas. |
output objectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
| |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. | |
code stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. | |
message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. |
Langkah 2: Tanyakan hasilnya
- Beijing
- Singapura
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}- Singapura
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Rekomendasi polling: Pembuatan video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang masuk akal, misalnya 15 detik.
- Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
- Tautan hasil: Setelah tugas berhasil, URL video yang berlaku selama 24 jam dikembalikan. Unduh dan simpan video ke penyimpanan permanen, seperti OSS.
task_idmasa berlaku: 24 jam. Setelah periode ini, kueri mengembalikan status tugas sebagaiUNKNOWN.
Parameter permintaan |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Header | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Parameter path | |
task_id string (Wajib)ID tugas. |
Parameter respons |
URL video hanya berlaku selama 24 jam, lalu secara otomatis dihapus. Segera simpan video yang dihasilkan. |
outputobjectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai Enumerasi
stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL video yang dihasilkan. Dikembalikan hanya saat task_status bernilai SUCCEEDED.Berlaku selama 24 jam. Video dalam format MP4 dengan encoding H.264.orig_prompt stringPrompt input asli, sesuai dengan parameter permintaan prompt.code stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode Kesalahan.message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode Kesalahan. | |
usage objectStatistik output. Dikembalikan hanya untuk tugas yang berhasil.
Properti duration floatTotal durasi video, digunakan untuk penagihan.Sama dengan output_video_duration.input_video_duration integerNilai tetap: 0.output_video_duration integerDurasi video output dalam detik. Sesuai dengan nilai input.duration.SR integerTingkat resolusi video output. Contoh: 720.ratio stringRasio aspek video output. Contoh: 16:9.video_count integerJumlah video yang dihasilkan. Selalu 1. | |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. |
HTTP (wan2.6 dan versi sebelumnya)
Tugas text-to-video memerlukan waktu 1–5 menit, sehingga API menggunakan pemanggilan asinkron: Buat tugas → Poll hasilnya.
Langkah 1: Buat tugas
- Singapura
- Virginia
- Beijing
- Frankfurt
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk menanyakan hasilnya.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.
Parameter permintaan |
|
Header permintaan | |
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json. | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus enable. | |
Body permintaan | |
model string (Wajib)Nama model. Untuk daftar model dan harga, lihat Harga model.Contoh: wan2.6-t2v. | |
input object (Wajib)Data input, termasuk prompt.
Properti prompt string (Wajib)Text prompt yang menjelaskan konten dan gaya visual video.Mendukung bahasa Tiongkok dan Inggris. Setiap karakter atau huruf dihitung sebagai satu. Teks yang melebihi batas akan dipotong secara otomatis. Panjang maksimum berdasarkan model:
string (Opsional)Elemen yang ingin dikecualikan dari video yang dihasilkan.Mendukung bahasa Tiongkok dan Inggris. Maksimal 500 karakter; teks yang lebih panjang akan dipotong secara otomatis.Contoh: low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions.audio_url string (Opsional)Model yang didukung: seri wan2.6 dan wan2.5.URL file audio untuk pembuatan video.Format yang didukung:
| |
parameters object (Opsional)Parameter pembuatan video: resolusi, penulisan ulang prompt, dan watermark.
Properti size string (Opsional)Resolusi video output dalam format lebar*tinggi. Nilai default dan valid tergantung pada model:
integer (Opsional)Durasi video output dalam detik. Nilai valid tergantung pada model:
boolean (Opsional)Mengaktifkan penulisan ulang prompt. Saat diaktifkan, LLM menulis ulang prompt input untuk meningkatkan kualitas. Paling baik untuk prompt pendek tetapi menambah latensi.
string (Opsional)Model yang didukung: model wan2.6.Struktur shot untuk video output: satu shot berkelanjutan atau beberapa shot dengan transisi.Nilai valid:
"prompt_extend": true diatur.Prioritas: shot_type menggantikan prompt. Mengatur shot_type ke single menghasilkan video single-shot meskipun prompt meminta multi-shot.watermark boolean (Opsional)Menambahkan watermark di pojok kanan bawah dengan teks "AI Generated".
integer (Opsional)Bilangan acak seed harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dihasilkan. Seed tetap meningkatkan reproduktibilitas.Karena generasi model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
Parameter respons |
Simpan task_id untuk menanyakan status dan hasil tugas. |
output objectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
| |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. | |
code stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. | |
message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. |
Langkah 2: Tanyakan hasilnya
- Singapura
- Virginia
- Beijing
- Frankfurt
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Rekomendasi polling: Pembuatan video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang masuk akal, misalnya 15 detik.
- Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
- Tautan hasil: Setelah tugas berhasil, URL video yang berlaku selama 24 jam dikembalikan. Unduh dan simpan video ke penyimpanan permanen, seperti OSS.
task_idmasa berlaku: 24 jam. Setelah periode ini, kueri mengembalikan status tugas sebagaiUNKNOWN.
Parameter permintaan |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Header | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Parameter path | |
task_id string (Wajib)ID tugas. |
Parameter respons |
URL video hanya berlaku selama 24 jam, lalu secara otomatis dihapus. Segera simpan video yang dihasilkan. |
outputobjectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL video yang dihasilkan. Dikembalikan hanya saat task_status bernilai SUCCEEDED.Berlaku selama 24 jam. Video dalam format MP4 dengan encoding H.264.orig_prompt stringPrompt input asli, sesuai dengan parameter permintaan prompt.actual_prompt stringSaat prompt_extend=true, sistem menulis ulang prompt input. Bidang ini berisi prompt yang ditulis ulang yang digunakan untuk generasi.
stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. | |
usage objectStatistik output. Dikembalikan hanya untuk tugas yang berhasil.
Properti video_duration integerDikembalikan hanya untuk wan2.5 dan versi sebelumnya (digunakan untuk penagihan).Durasi video output dalam detik. Nilai valid: 5, 10.duration floatDikembalikan hanya untuk wan2.6 (digunakan untuk penagihan).Total durasi video. Rumus: duration=input_video_duration+output_video_duration.input_video_duration integerDikembalikan hanya untuk wan2.6. Nilai tetap: 0.output_video_duration integerDikembalikan hanya untuk wan2.6.Durasi video output dalam detik. Sesuai dengan nilai input.duration.SR integerDikembalikan hanya untuk wan2.6. Tingkat resolusi video output. Contoh: 720.size stringDikembalikan hanya untuk wan2.6. Resolusi output dalam format "lebar×tinggi". Contoh: 1920×1080.video_ratio stringDikembalikan hanya untuk wan2.5 dan versi sebelumnya. Resolusi output dalam format "lebar×tinggi". Contoh: 832×480.video_count integerJumlah video yang dihasilkan. Selalu 1. | |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. |
SDK DashScope
Nama parameter SDK sebagian besar sesuai dengan API HTTP, dengan struktur mengikuti konvensi khusus bahasa.
Tugas text-to-video memerlukan waktu 1–5 menit. SDK membungkus alur panggilan HTTP asinkron dan mendukung pemanggilan sinkron maupun asinkron.
Waktu pemrosesan aktual tergantung pada kedalaman antrian dan beban layanan.
SDK Python
Atur dashscope.base_http_api_url ke endpoint wilayah:
- Beijing
- Singapura
- Virginia
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Pemanggilan sinkron
- Pemanggilan asinkron
Contoh permintaan
Contoh respons
video_url kedaluwarsa setelah 24 jam. Unduh segera.
SDK Java
Atur Constants.baseHttpApiUrl ke endpoint wilayah:
- Singapura
- Virginia
- Beijing
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Pemanggilan sinkron
- Pemanggilan asinkron
Contoh permintaan
Contoh respons
video_url kedaluwarsa setelah 24 jam. Unduh segera.
Batasan
- Retensi data: ID tugas (
task_id) dan URL video (video_url) kedaluwarsa setelah 24 jam. Setelah kedaluwarsa, tidak dapat dikueri atau diunduh. - Moderasi konten: Input dan output menjalani moderasi konten. Konten terlarang memicu kesalahan "IPInfringementSuspect" atau "DataInspectionFailed". Lihat Kode kesalahan.
Kode kesalahan
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk penyelesaian.
FAQ
Q: Perubahan kode apa yang diperlukan untuk upgrade dari wan2.6 ke wan2.7?
A: Diperlukan dua perubahan:
- Kontrol resolusi: wan2.7 menggantikan field
size. Sebagai gantinya, menggunakan kombinasiresolution(tingkat resolusi) danratio(rasio aspek) untuk menentukan resolusi output. Model sebelumnya menggunakan fieldsize. - Penghapusan jenis shot: wan2.7 menghapus field
shot_type. Jelaskan struktur shot langsung dalam prompt sebagai gantinya.
Q: Bagaimana cara mengonversi tautan video sementara menjadi tautan permanen?
A: Konversi langsung tidak dimungkinkan. Unduh video dari URL tersebut, lalu unggah ke penyimpanan persisten (seperti Alibaba Cloud OSS) untuk menghasilkan tautan permanen.
Kode contoh: Unduh video ke perangkat lokal
Kode contoh: Unduh video ke perangkat lokal