Model Wan - referensi-ke-video mendukung input multi-modal (teks, gambar, dan video) serta menghasilkan video yang menampilkan satu atau beberapa karakter. Model ini mendukung pertunjukan karakter tunggal maupun adegan interaktif multi-karakter, serta pembagian shot cerdas untuk menghasilkan video multi-shot.
Referensi: Panduan pengguna
Cakupan
Agar pemanggilan API berhasil, model, URL titik akhir, dan kunci API harus berada di wilayah yang sama. Pemanggilan lintas-wilayah akan gagal.
Pilih model: Pastikan model tersedia di wilayah target Anda.
Pilih URL: Gunakan URL titik akhir regional yang sesuai. URL HTTP didukung.
Konfigurasikan kunci API: Pilih wilayah, dapatkan kunci API, dan konfigurasikan dalam variabel lingkungan.
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.
Pemanggilan HTTP
Tugas referensi-ke-video biasanya memerlukan waktu 1 hingga 5 menit. Oleh karena itu, API menggunakan pemanggilan asinkron. Alur kerja lengkapnya terdiri dari dua langkah inti: buat tugas, lalu lakukan polling untuk hasilnya:
Langkah 1: Buat tugas
Singapura
POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Virginia
POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Beijing
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
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 tutorial pemula, lihat Gunakan Postman atau cURL.
Parameter permintaan | Interaksi multi-karakter (gambar dan video referensi)Teruskan URL gambar dan video dalam Interaksi multi-karakter (video referensi)Teruskan beberapa URL video dalam Asumsi peran karakter tunggalTeruskan satu URL video dalam Hasilkan video tanpa suaraHanya Untuk menghasilkan video tanpa suara, atur secara eksplisit |
Header permintaan | |
Content-Type Tipe konten permintaan. Harus berupa | |
Authorization Kredensial otentikasi menggunakan kunci API Model Studio. Contoh: | |
X-DashScope-Async Mengaktifkan pemrosesan asinkron. Harus diatur ke Penting Mengembalikan kesalahan "current user api does not support synchronous calls" jika tidak disertakan. | |
Body permintaan | |
model Nama model. Untuk daftar model dan harga, lihat Harga model. Contoh: wan2.6-r2v-flash. | |
input Informasi input dasar, seperti prompt. | |
parameters Parameter untuk resolusi video, penulisan ulang prompt, dan watermark. |
Parameter respons | Respons suksesSimpan Respons kesalahanPembuatan tugas gagal. Lihat kode kesalahan untuk menyelesaikan masalah. |
output Output tugas. | |
request_id Pengenal unik untuk permintaan. Gunakan untuk pelacakan dan troubleshooting masalah. | |
code Kode kesalahan. Dikembalikan hanya saat permintaan gagal. Lihat kode kesalahan untuk detailnya. | |
message Pesan kesalahan detail. Dikembalikan hanya saat permintaan gagal. Lihat kode kesalahan untuk detailnya. |
Langkah 2: Kueri hasil
Singapura
GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}
Virginia
GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}
Beijing
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
Saran polling: Pembuatan video dapat memakan waktu beberapa menit. Gunakan mekanisme polling dengan interval kueri yang wajar, misalnya 15 detik, untuk mengambil hasilnya.
Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
URL hasil: Setelah tugas berhasil, URL video dikembalikan. URL tersebut berlaku selama 24 jam. Setelah Anda mendapatkan URL tersebut, segera unduh dan simpan video ke layanan penyimpanan permanen, seperti Object Storage Service (OSS).
Validitas task_id: 24 jam. Setelah periode ini, Anda tidak dapat mengkueri hasilnya, dan API mengembalikan status tugas
UNKNOWN.
Parameter permintaan | Hasil tugas kueriGanti |
Header permintaan | |
Authorization Kredensial otentikasi menggunakan kunci API Model Studio. Contoh: | |
Parameter path URL | |
task_id ID Tugas yang akan dikueri. |
Parameter respons | Tugas berhasilURL video hanya disimpan selama 24 jam lalu secara otomatis dihapus. Segera simpan video yang dihasilkan. Tugas gagalSaat tugas gagal, Kueri tugas kedaluwarsa
|
output Output tugas. | |
usage Statistik output. Dihitung hanya untuk tugas yang berhasil. | |
request_id Pengenal unik untuk permintaan. Gunakan untuk pelacakan dan troubleshooting masalah. |
Batasan
Validitas data:
task_iddanvideo_urlvideo hanya disimpan selama 24 jam. Setelah kedaluwarsa, tidak dapat dikueri atau diunduh.Moderasi konten: Baik prompt input maupun video output menjalani moderasi konten. Permintaan yang berisi konten tidak sesuai akan mengembalikan kesalahan `IPInfringementSuspect` atau `DataInspectionFailed`. Untuk detailnya, lihat Pesan kesalahan.
Kode kesalahan
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Pesan kesalahan untuk penyelesaiannya.
FAQ
T: Bagaimana cara mendapatkan daftar putih nama domain untuk penyimpanan video?
J: Video yang dihasilkan oleh model disimpan di OSS. API mengembalikan URL publik sementara. Untuk mengonfigurasi daftar putih firewall untuk URL unduhan ini, perhatikan hal berikut: Penyimpanan dasar dapat berubah secara dinamis. Topik ini tidak menyediakan daftar putih nama domain OSS tetap untuk mencegah masalah akses akibat informasi yang kedaluwarsa. Jika Anda memiliki persyaratan kontrol keamanan, hubungi manajer akun Anda untuk mendapatkan daftar nama domain OSS terbaru.