Parameter permintaan Header permintaan (Headers) Content-Type string (Wajib) Tipe konten permintaan. Harus berupa 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 diatur ke enable. PentingJika header permintaan ini tidak disertakan, kesalahan "current user api does not support synchronous calls" akan dikembalikan. Isi permintaan (Request Body) model string (Wajib) Nama model. Nilai tetap: wan3.0-video. input object (Wajib) Informasi input dasar. Salah satu dari prompt atau media harus disediakan. Properti prompt string (Wajib kondisional) Prompt teks yang digunakan untuk menggambarkan konten video yang diinginkan. Salah satu dari ini atau media harus disediakan. Mendukung bahasa Tionghoa dan Inggris. Setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter, dengan batas maksimum 20.000 karakter. Konten yang melebihi batas ini akan dipotong secara otomatis. Dalam mode referensi, Anda dapat menggunakan "Gambar 1", "Video 1", dll. dalam prompt untuk merujuk ke aset media sesuai urutan dalam array media. media array (Wajib kondisional) Array aset media yang mendukung gambar, video, audio, file, dan halaman web sebagai input. Salah satu dari ini atau prompt harus disediakan.
-
Setiap elemen dalam array adalah objek media yang berisi bidang type dan url.
-
Dalam mode generasi video berbasis referensi, urutan array menentukan urutan referensi aset dalam prompt. Gambar dan video dihitung secara terpisah, artinya Gambar 1 dan Video 1 dapat eksis bersamaan.
reference_video ke-1 dalam array bersesuaian dengan Video 1, yang ke-2 bersesuaian dengan Video 2, dan seterusnya.reference_image ke-1 dalam array bersesuaian dengan Gambar 1, yang ke-2 bersesuaian dengan Gambar 2, dan seterusnya.reference_audio ke-1 dalam array bersesuaian dengan Audio 1, yang ke-2 bersesuaian dengan Audio 2, dan seterusnya.
Properti type string (Wajib) Jenis aset media. Nilai valid:
first_frame: Gambar frame pertama. Maksimal 1 gambar, digunakan secara ketat sebagai frame pertama video.last_frame: Gambar frame terakhir. Maksimal 1 gambar, digunakan secara ketat sebagai frame terakhir video.reference_image: Gambar referensi. Maksimal 10 gambar.reference_video: Video referensi. Maksimal 5 klip, dengan total durasi tidak lebih dari 15 detik.reference_audio: Audio referensi. Maksimal 5 klip, dengan total durasi tidak lebih dari 15 detik.file: File. Maksimal 1 file, tidak dapat digunakan bersamaan dengan link.link: Tautan web. Maksimal 1 tautan, tidak dapat digunakan bersamaan dengan file. PentingTipe reference_xx/file/link dan tipe first_frame/last_frame saling eksklusif dan tidak dapat digunakan bersamaan dalam satu permintaan. url string (Wajib) URL aset media atau data yang dikodekan Base64. parameters object (Opsional) Parameter pemrosesan video. Properti resolution string (Opsional) Tingkat resolusi video yang dihasilkan. Nilai default: 1080P. Nilai valid: ratio string (Opsional) Rasio aspek video yang dihasilkan. Nilai valid:
adaptive (Nilai default): Rasio aspek adaptif yang secara otomatis merekomendasikan rasio aspek yang sesuai berdasarkan proporsi media input dan maksudnya.16:94:31:13:49:16 duration integer (Opsional) Durasi video yang dihasilkan, dalam satuan detik. Nilai default: 5.
- Tanpa input video: bilangan bulat dalam rentang [2, 30].
- Dengan input video: total durasi video input + durasi video output tidak boleh melebihi 30 detik.
- Jika diatur ke
-1: Mode durasi cerdas, di mana model secara otomatis merekomendasikan durasi yang sesuai berdasarkan prompt input, konten, dan media kaya.
audio boolean (Opsional) Apakah video output berisi audio.
true: Nilai default, video output berisi audio.false: Video output tidak berisi trek audio. Mengaktifkan atau menonaktifkan audio tidak memengaruhi harga. seed integer (Opsional) Seed acak. Digunakan untuk mereproduksi hasil generasi. Rentang nilai: -1 atau [0, 2147483647]. Jika diatur ke -1 atau tidak ditentukan, sistem secara otomatis menghasilkan seed acak. Meskipun menggunakan seed yang sama, hasil generasi mungkin tidak selalu identik. prompt_extend boolean (Opsional) Apakah akan mengaktifkan penulisan ulang prompt cerdas. Saat diaktifkan, model bahasa besar akan menulis ulang prompt input. Ini secara signifikan meningkatkan kualitas generasi untuk prompt yang lebih pendek, tetapi meningkatkan latensi.
true: Nilai default, penulisan ulang cerdas diaktifkan.false: Penulisan ulang cerdas dinonaktifkan. watermark boolean (Opsional) Apakah akan menambahkan Watermark.
false: Nilai default, tidak ada Watermark yang ditambahkan.true: Watermark ditambahkan. | File Reference to VideoMasukkan file melalui tipe file, dan model secara otomatis memahami konten file tersebut untuk menghasilkan video. curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "Iklan produk kacamata pintar premium dengan gaya minimalis, futuristik, dan modis. Palet warna menampilkan nuansa hitam, abu-abu perak, dan biru es dengan aksen cahaya putih halus serta grafis UI parameter. Dimulai dengan latar belakang hitam pekat, sepasang kacamata pintar perlahan muncul dari kegelapan dengan sorotan halus pada ujung gagangnya. Kamera menangkap detail ultra-dekat lensa, bantalan hidung, engsel, gagang, dan tekstur material, menampilkan material logam dan komposit berkinerja-tinggi. Produk kemudian berputar perlahan di udara dengan grafis gerak minimalis yang menampilkan parameter inti. Lalu kamera menjauh saat semua bagian secara tepat menyatu kembali menjadi produk lengkap, beralih ke model muda yang memakainya dalam ruang minimalis dan lingkungan pencahayaan perkotaan.",
"media": [
{
"type": "file",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260806/ebapmr/glass.pptx"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 10,
"prompt_extend": true
}
}'
Reference-based Video GenerationMasukkan gambar referensi, video, audio, file, atau tautan web melalui input.media, dan model secara otomatis memahami maksudnya untuk menghasilkan video. curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "Video 1 memegang Gambar 3 dan memainkan lagu country folk yang menenangkan di kursi pada Gambar 4, berkata: '\''Cuaca cerah hari ini.'\'' Gambar 1 memegang Gambar 2, melewati Video 1, meletakkan Gambar 2 di atas meja di samping Video 1, dan berkata: '\''Kedengarannya indah, bisakah kamu menyanyikannya lagi?'\''",
"media": [
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
},
{
"type": "reference_video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
Text-to-VideoHasilkan video hanya menggunakan prompt, tanpa memasukkan file media apa pun. curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "Seekor anak kucing berlari di atap gedung di bawah cahaya bulan, lampu neon kota berkedip di kejauhan, kualitas sinematik, gerakan kamera yang mulus."
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
First Frame to VideoTentukan secara ketat gambar frame pertama video menggunakan first_frame. curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "Adegan seni fantasi urban. Karakter seni grafiti dinamis. Remaja yang dilukis semprot hidup dari dinding beton. Ia nge-rap dengan kecepatan sangat tinggi sambil berpose klasik energetik ala rapper. Adegan berlatar di bawah jembatan kereta api pada malam hari dengan suasana urban. Pencahayaan berasal dari satu lampu jalan, menciptakan atmosfer sinematik penuh energi tinggi dan detail memukau. Audio video hanya terdiri dari rap, tanpa dialog atau kebisingan lainnya.",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
First-Last Frame to VideoMasukkan first_frame dan last_frame untuk menentukan secara ketat gambar frame pertama dan terakhir video. curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan3.0-video",
"input": {
"prompt": "Seorang gadis muda secara bertahap berubah dari tersenyum menjadi tertawa, kamera perlahan mendekat, pencahayaan latar berubah dari nada dingin ke hangat.",
"media": [
{
"type": "first_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
},
{
"type": "last_frame",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
}
]
},
"parameters": {
"resolution": "480P",
"ratio": "adaptive",
"duration": 5,
"prompt_extend": true
}
}'
|
