Model Wanxiang-Reference-to-Video mendukung multimodal input, seperti teks, gambar, dan video. Model ini dapat menghasilkan pertunjukan karakter tunggal atau interaksi multi-karakter dengan manusia atau objek sebagai subjek utama, serta mendukung segmentasi adegan cerdas untuk membuat video multi-shot.
Referensi: Panduan Pengguna
Cakupan Penggunaan
Untuk memastikan pemanggilan berhasil, pastikan model, URL endpoint, dan Kunci API berada di wilayah yang sama. Pemanggilan lintas-wilayah akan gagal.
Pilih Model: Konfirmasi wilayah model Anda.
Pilih URL: Gunakan URL endpoint yang sesuai dengan wilayah Anda. URL HTTP didukung.
Konfigurasikan Kunci API Anda: Pilih wilayah Anda dan dapatkan Kunci API Anda. Kemudian, konfigurasikan Kunci API Anda sebagai Variabel lingkungan. Perhatikan bahwa metode ini sedang ditinggalkan dan akan digabungkan ke dalam konfigurasi Kunci API.
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.
Pemanggilan HTTP
Karena tugas reference-to-video memakan waktu lama (biasanya 1 hingga 5 menit), API menggunakan pemanggilan asinkron. Alur kerja lengkap terdiri dari dua langkah inti: Buat tugas → Polling hasil.
Langkah 1: Buat Tugas dan Dapatkan ID Tugas
Singapura
POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
AS (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 Panggil API generasi gambar dan video menggunakan Postman atau cURL.
Parameter Permintaan | Interaksi Multi-Karakter (Menggunakan Gambar dan Video Referensi)Teruskan URL gambar dan video dalam Interaksi Multi-Karakter (Menggunakan Hanya Video Referensi)Teruskan beberapa URL video dalam Peran Tunggal Bermain PeranTeruskan satu URL video dalam Hasilkan Video Tanpa SuaraHanya Saat menghasilkan video tanpa suara, Anda harus secara eksplisit mengatur |
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 lengkap dan detail harga, lihat Harga Model. Nilai contoh: wan2.6-r2v-flash. | |
input Informasi input dasar, seperti prompt. | |
parameters Parameter pemrosesan video, seperti pengaturan resolusi. |
Parameter Tanggapan | Tanggapan BerhasilSimpan Tanggapan KesalahanPembuatan tugas gagal. Lihat kode kesalahan untuk menyelesaikan masalah. |
output Informasi output tugas. | |
request_id Pengenal unik untuk permintaan. Digunakan 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 Menggunakan ID Tugas
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: Generasi 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, segera unduh dan simpan video ke layanan penyimpanan permanen, seperti Object Storage Service (OSS).
Masa berlaku task_id: 24 jam. Setelah periode ini, Anda tidak dapat mengkueri hasilnya, dan API mengembalikan status tugas
UNKNOWN.
Parameter Permintaan | Kueri Hasil TugasGanti |
Header Permintaan | |
Authorization Kredensial otentikasi menggunakan Kunci API Model Studio. Contoh: | |
Parameter Jalur URL | |
task_id ID tugas yang akan dikueri. |
Parameter Tanggapan | 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 Informasi output tugas. | |
usage Statistik penggunaan. Ini hanya dihitung untuk hasil yang berhasil. | |
request_id Pengenal unik untuk permintaan. Digunakan untuk pelacakan dan troubleshooting masalah. |
Batasan
Kedaluwarsa Data:
task_iddanvideo_urlkeduanya kedaluwarsa setelah 24 jam. Setelah kedaluwarsa, Anda tidak dapat mengkueri atau mengunduhnya.Moderasi Konten: Prompt input dan video output menjalani moderasi konten. Permintaan yang berisi konten terlarang mengembalikan kesalahan seperti `IPInfringementSuspect` atau `DataInspectionFailed`. Untuk informasi lebih lanjut, lihat Informasi Kesalahan.
Kode kesalahan
Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Pesan kesalahan untuk penyelesaian.
FAQ
T: Bagaimana cara mendapatkan daftar putih nama domain untuk akses 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.