Model reference-to-video Wan menerima input multimodal dan menghasilkan video interaksi karakter tunggal atau multi-karakter dengan menjadikan orang atau objek sebagai protagonis.
Lihat juga: Panduan pengguna
Model, URL endpoint, dan Kunci API harus berada di wilayah yang sama. Pemanggilan lintas wilayah akan gagal.
Tugas generasi video biasanya memerlukan waktu 1–5 menit. API menggunakan panggilan asinkron dua langkah: "buat tugas → polling hasil". Detailnya sebagai berikut:
Parameter SDK mengikuti konvensi penamaan yang sama dengan API HTTP, dengan wrapper khusus bahasa.
Tugas reference-to-video biasanya memerlukan waktu 1–5 menit. SDK membungkus alur kerja asinkron HTTP dan mendukung panggilan sinkron maupun asinkron.
Atur
Atur
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk solusinya.
Ketersediaan
Model, URL endpoint, dan Kunci API harus berada di wilayah yang sama. Pemanggilan lintas wilayah akan gagal.
- Pilih model: Konfirmasi wilayah model tersebut.
- Pilih URL: Gunakan URL endpoint untuk wilayah yang sesuai. URL HTTP didukung.
- Konfigurasikan Kunci API: Pilih wilayah dan Dapatkan Kunci API, lalu Konfigurasikan Kunci API sebagai Variabel lingkungan.
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.
HTTP
Tugas generasi video biasanya memerlukan waktu 1–5 menit. API menggunakan panggilan asinkron dua langkah: "buat tugas → polling hasil". Detailnya sebagai berikut:
Langkah 1: Buat tugas
- Singapura
- AS (Virginia)
- Frankfurt
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisGanti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk mengkueri 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 permintaanHeaderContent-Typestring (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 permintaanmodelstring (Wajib)Model yang digunakan. Lihat Harga model untuk model yang tersedia dan harganya.Contoh: wan2.6-r2v-flash.input object (Wajib)Parameter input seperti prompt.
Properti prompt string (Wajib)Prompt teks yang menggambarkan elemen dan karakteristik visual yang diinginkan dari video yang dihasilkan.Mendukung bahasa Tiongkok dan Inggris. Setiap karakter dihitung sebagai satu. Konten yang melebihi batas akan dipotong secara otomatis.
string (Opsional)Prompt negatif yang menggambarkan elemen yang tidak diinginkan dalam video.Mendukung bahasa Tiongkok dan Inggris. Panjang maksimum: 500 karakter. Konten yang melebihi batas akan dipotong secara otomatis.Contoh: resolusi rendah, error, kualitas terburuk, kualitas rendah, tidak lengkap, jari ekstra, proporsi buruk, dll.reference_urls array[string] (Wajib)Array URL file referensi. Mendukung input video dan gambar. Digunakan untuk mengekstraksi penampilan karakter dan suara (jika tersedia) guna menghasilkan video yang sesuai dengan karakteristik referensi.
Usang reference_video_urls array[string]Array URL video referensi. Digunakan untuk mengekstraksi penampilan karakter dan suara (jika tersedia) guna menghasilkan video yang sesuai dengan karakteristik referensi.
object (Opsional)Parameter generasi video seperti resolusi, penulisan ulang prompt, dan watermark.
Properti size string (Opsional)Resolusi video yang dihasilkan, dalam format lebar*tinggi. Nilai default dan opsi yang tersedia bergantung pada parameter model:
integer (Opsional)Durasi video yang dihasilkan, dalam satuan detik.
string (Opsional)Komposisi shot video yang dihasilkan, menentukan apakah video terdiri dari satu shot berkelanjutan atau beberapa shot.Prioritas parameter: shot_type > prompt. Misalnya, jika shot_type diatur ke "single", model menghasilkan video single-shot meskipun prompt menyatakan "hasilkan video multi-shot".Nilai yang valid:
Gunakan parameter ini untuk mengontrol struktur naratif video, seperti single-shot untuk pameran produk atau multi-shot untuk klip cerita. boolean (Opsional)Model yang didukung: wan2.6-r2v-flash.Apakah akan menghasilkan audio dalam video.Nilai yang valid:
boolean (Opsional)Apakah akan menambahkan watermark. Watermark muncul di pojok kanan bawah dengan teks "AI-generated".
integer (Opsional)Bilangan acak seed harus berupa integer dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dihasilkan. Seed tetap meningkatkan kemampuan reproduksi.Karena generasi model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
Teruskan URL gambar dan video melalui reference_urls. Atur shot_type ke multi untuk video multi-shot. |
Parameter responsoutputobjectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringPengenal permintaan unik untuk pelacakan dan troubleshooting.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk mengkueri status dan hasil tugas. |
Langkah 2: Ambil hasil tugas
- Singapura
- AS (Virginia)
- Frankfurt
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Rekomendasi polling: Generasi video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang wajar, 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 permintaanHeaderAuthorizationstring (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Parameter pathtask_idstring (Wajib)ID tugas. |
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. |
Parameter responsoutputobjectOutput tugas.
Properti task_id string (Wajib)ID tugas.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL video yang dihasilkan. Hanya dikembalikan 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. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.objectStatistik penggunaan. Hanya menghitung hasil yang berhasil.
Properti input_video_duration integerDurasi video referensi input, dalam satuan detik.output_video_duration integerDurasi video output, dalam satuan detik.duration floatTotal durasi video. Penagihan didasarkan pada nilai ini.Rumus: duration = input_video_duration + output_video_duration.SR integerTingkat resolusi video yang dihasilkan. Contoh: 720.size stringResolusi video yang dihasilkan dalam format lebar*tinggi. Contoh: 1280*720.video_count integerJumlah video yang dihasilkan. Selalu 1.stringPengenal permintaan unik untuk pelacakan dan troubleshooting. |
URL video hanya berlaku selama 24 jam dan kemudian secara otomatis dihapus. Segera simpan video yang dihasilkan. |
DashScope SDK
Parameter SDK mengikuti konvensi penamaan yang sama dengan API HTTP, dengan wrapper khusus bahasa.
Tugas reference-to-video biasanya memerlukan waktu 1–5 menit. SDK membungkus alur kerja asinkron HTTP dan mendukung panggilan sinkron maupun asinkron.
Waktu pemrosesan aktual bergantung pada antrian tugas dan beban server.
Python
Atur base_http_api_url berdasarkan wilayah model:
- Singapura
- China (Beijing)
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Sinkron
- Asinkron
Panggilan sinkron memblokir hingga generasi video selesai dan hasil dikembalikan.
Contoh permintaan
Java
Atur baseHttpApiUrl berdasarkan wilayah model:
- Singapura
- China (Beijing)
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Sinkron
- Asinkron
Panggilan sinkron memblokir hingga generasi video selesai dan hasil dikembalikan.