Model gambar ke video Vidu menghasilkan video yang mulus dari gambar input dan prompt teks.
Catatan penggunaan
Agar panggilan API berhasil, gunakan model, URL endpoint, dan API key dari wilayah yang sama. Panggilan lintas wilayah akan gagal.
- Pilih model: Pastikan wilayah tempat model Anda berada.
- Pilih URL: Pilih URL endpoint yang sesuai. URL HTTP maupun DashScope SDK didukung.
- Konfigurasikan API key: Pilih wilayah, dapatkan API key, lalu konfigurasikan API key sebagai variabel lingkungan.
Contoh kode dalam topik ini berlaku untuk wilayah Singapura.
Panggilan HTTP
Pembuatan video dari gambar biasanya memerlukan 1 hingga 5 menit, sehingga API menggunakan model asinkron. Alurnya terdiri dari dua langkah utama: buat tugas, lalu lakukan polling hasilnya.
Langkah 1: Buat tugas
Wilayah Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk mengueri hasil.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Memanggil API dengan Postman atau cURL.
Parameter permintaanHeaderContent-Typestring (Wajib)Jenis konten permintaan. Harus application/json.Content-Type string (Wajib)Jenis konten permintaan. Harus application/json.X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus enable.Isi permintaanmodelstring (Wajib)Nama model. Nilai yang valid:
object (Wajib)Input dasar, termasuk prompt teks dan aset media.
Properti prompt string (Opsional)Prompt teks yang menjelaskan elemen dan karakteristik visual yang diinginkan dalam video yang dihasilkan.Panjang maksimum adalah 5.000 karakter (karakter bahasa Mandarin dan huruf bahasa Inggris masing-masing dihitung satu). Teks yang melebihi batas dipotong.media array (Wajib)Daftar aset media yang menentukan gambar untuk pembuatan video.Setiap elemen array adalah objek media yang berisi field type dan url.
Properti type string (Wajib)Jenis aset media. Harus diatur ke nilai tetap berikut:
string (Wajib)URL file gambar, yang harus dapat diakses publik.
object (Opsional)Parameter pemrosesan video, seperti resolusi dan durasi.
Properti resolution string (Opsional)Menentukan tingkat resolusi video yang dihasilkan.Model menyesuaikan skala video ke jumlah piksel yang mendekati tingkat pilihan sambil mempertahankan rasio aspek gambar input.Nilai yang valid adalah 720P dan 1080P. Default: 720P.duration integer (Opsional)Durasi video yang dihasilkan, dalam detik.Bilangan bulat dalam rentang [1, 10]. Default: 5.audio boolean (Opsional)watermark boolean (Opsional)Menentukan apakah watermark ditambahkan. Watermark ditempatkan di sudut kanan bawah video dengan teks tetap "Generated by AI".
integer (Opsional)Seed bilangan acak harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dibuat. Seed tetap meningkatkan reproduktibilitas.Karena pembuatan oleh model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
|
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringPengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk mengueri status dan hasil tugas. |
Langkah 2: Kueri hasil
Wilayah Singapura: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
- Rekomendasi polling: Pembuatan video dapat memerlukan beberapa menit. Lakukan polling hasil dengan interval yang wajar, misalnya setiap 15 detik.
- Alur status tugas:
PENDING(dalam antrean) →RUNNING(diproses) →SUCCEEDED(berhasil) /FAILED(gagal). - Masa berlaku ID tugas:
task_idberlaku selama 24 jam. Setelah itu, kueri akan gagal dan mengembalikan statusUNKNOWN. - Batas RPS: Endpoint kueri memiliki batas default 20 RPS. Untuk kueri berfrekuensi tinggi atau notifikasi peristiwa, konfigurasikan callback tugas asinkron.
- Operasi lainnya: Untuk melakukan kueri batch, membatalkan tugas, atau operasi lain, lihat Mengelola Tugas Asinkron.
Parameter permintaanHeaderAuthorizationstring (Wajib)Mengautentikasi permintaan dengan API key Model Studio. Contoh: Bearer sk-xxxx.Parameter jalurtask_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 |
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu tugas dikirim. Format: YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu tugas dijalankan. Format: YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu tugas selesai. Format: YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu tugas selesai. Format: YYYY-MM-DD HH:mm:ss.SSS.orig_prompt stringURL video. Hanya dikembalikan saat task_status adalah SUCCEEDED.Format video adalah MP4 (pengodean H.264). Tautan video berlaku selama 24 jam. Segera unduh video.orig_prompt stringPrompt input asli, sesuai parameter permintaan prompt.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.objectStatistik penggunaan output, hanya dihitung untuk tugas yang berhasil.
Properti duration integerTotal durasi video yang ditagihkan, dalam detik.output_video_durationintegerDurasi video output, dalam detik.size stringResolusi video output.fps integerFrame rate video output. Tetap pada 24.SR stringTingkat resolusi video output.audio booleanMenunjukkan apakah output berupa video dengan audio.video_count integerJumlah video output. Tetap pada 1.stringPengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah. |
|