Model pengeditan video Wan 2.7 menerima input multimodal (teks, gambar, dan video) untuk pengeditan berbasis instruksi dan style transfer .
Dokumen terkait: Panduan
Model, URL titik akhir, dan Kunci API harus berada di Wilayah yang sama. Panggilan lintas-wilayah akan gagal.
Tugas pengeditan video biasanya memerlukan waktu 1 hingga 5 menit. API menggunakan panggilan asinkron dengan dua langkah utama: Buat tugas → Polling hasilnya.
Ganti
Ganti
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP, tetapi struktur parameternya mengikuti konvensi masing-masing bahasa.
Pengeditan video biasanya memerlukan waktu 1 hingga 5 menit. SDK menangani proses panggilan HTTP asinkron secara internal, mendukung panggilan sinkron maupun asinkron.
Tetapkan base_http_api_url berdasarkan wilayah layanan:
Ganti
Tetapkan Constants.baseHttpApiUrl berdasarkan wilayah layanan:
Ganti
Jika panggilan model gagal, lihat Kode kesalahan untuk troubleshooting.
Penerapan
Model, URL titik akhir, dan Kunci API harus berada di Wilayah yang sama. Panggilan lintas-wilayah akan gagal.
- Pilih model: Konfirmasi wilayah model tersebut.
- Pilih URL titik akhir: Gunakan URL titik akhir yang sesuai dengan wilayah Anda. Didukung melalui HTTP dan SDK DashScope.
- Konfigurasikan Kunci API: Dapatkan Kunci API untuk wilayah tersebut, lalu konfigurasikan sebagai variabel lingkungan.
Kode contoh dalam topik ini menggunakan Singapura.
HTTP
Tugas pengeditan video biasanya memerlukan waktu 1 hingga 5 menit. API menggunakan panggilan asinkron dengan dua langkah utama: Buat tugas → Polling hasilnya.
Langkah 1: Buat tugas
- Singapura
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{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 permintaanContent-Typestring (Wajib)Tipe konten permintaan. Harus application/json.Authorization string (Wajib)Mengautentikasi 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.Isi permintaanmodelstring (Wajib)Nama model.Nilai contoh: wan2.7-videoedit.input object (Wajib)Parameter input, termasuk prompt.
Properti prompt string (Opsional)Menjelaskan elemen dan fitur visual yang diinginkan dalam video yang dihasilkan.Bahasa Mandarin dan Inggris didukung. Setiap karakter Mandarin atau huruf Inggris dihitung sebagai satu karakter. Teks yang lebih panjang akan dipotong secara otomatis.
string (Opsional)Prompt negatif yang menjelaskan konten yang harus dikecualikan dari video, membantu menyempurnakan output.Bahasa Mandarin dan Inggris didukung. Panjangnya tidak boleh melebihi 500 karakter. Teks yang lebih panjang akan dipotong secara otomatis.Nilai contoh: low resolution, error, worst quality, low quality, disfigured, extra fingers, bad proportions.media array (Wajib)Daftar aset media, seperti gambar dan video, yang digunakan sebagai referensi untuk pembuatan video.Setiap elemen dalam array adalah objek media yang berisi bidang type dan url.
Properti type string (Wajib)Jenis aset media. Nilai yang valid:
string (Wajib)URL, data terenkripsi Base64, atau asset_id Asset Center dari aset media. Aset mencakup video dan gambar.
Video input (type=video) URL atau asset_id Asset Center dari file video yang akan diedit.Persyaratan video:
Gambar input (type=reference_image) URL, data terenkripsi Base64, atau asset_id Asset Center dari gambar referensi.Persyaratan gambar:
object (Opsional)Parameter untuk pemrosesan video, seperti resolusi, durasi, penulisan ulang prompt cerdas, dan watermark.
Properti resolution string (Opsional)Tingkat resolusi video yang dihasilkan, yang mengontrol kejernihannya (total piksel).
string (Opsional)Rasio aspek video yang dihasilkan.Perilaku:
integer (Opsional)Durasi video yang dihasilkan, dalam detik.Rekomendasi: Tetapkan parameter ini hanya untuk memotong video. Untuk mempertahankan durasi yang sama dengan video input, abaikan parameter ini atau berikan nilai default 0.Aturan penggunaan:
string (Opsional)Pengaturan suara video.
boolean (Opsional)Mengaktifkan penulisan ulang prompt cerdas. Saat diaktifkan, model besar akan menulis ulang prompt input, secara signifikan meningkatkan kualitas generasi untuk prompt yang lebih pendek dengan biaya peningkatan waktu pemrosesan.
boolean (Opsional)Apakah akan menambahkan watermark. Watermark berada di pojok kanan bawah video dengan teks "AI Generated".
integer (Opsional)Bilangan acak seed harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dihasilkan. Seed tetap meningkatkan reproduktibilitas.Karena generasi model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
Parameter responsoutputobjectBerisi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringIdentifier 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: Kueri hasilnya
- Singapura
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Rekomendasi polling: Pembuatan video memerlukan beberapa menit. Gunakan mekanisme polling dengan interval yang masuk akal, 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 akan mengembalikan status tugas sebagaiUNKNOWN.
Parameter permintaanHeaderAuthorizationstring (Wajib)Mengautentikasi permintaan dengan Kunci API 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, Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Parameter responsoutputobjectBerisi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu saat tugas dikirimkan. 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 enkode 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 untuk penagihan. Hanya ditagih untuk tugas yang berhasil.
Properti input_video_duration floatDurasi video input, dalam detik.output_video_duration floatDurasi video output, dalam detik.duration floatTotal durasi video, yang digunakan untuk penagihan.Rumus penagihan: duration=input_video_duration+output_video_duration.SR integerTingkat resolusi video output. Nilai contoh: 720.video_count integerJumlah video yang dihasilkan. Nilai ini tetap 1.stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. |
URL video hanya berlaku selama 24 jam, lalu secara otomatis dihapus. Segera simpan video yang dihasilkan. |
DashScope SDK
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP, tetapi struktur parameternya mengikuti konvensi masing-masing bahasa.
Pengeditan video biasanya memerlukan waktu 1 hingga 5 menit. SDK menangani proses panggilan HTTP asinkron secara internal, mendukung panggilan sinkron maupun asinkron.
Waktu pemrosesan aktual bergantung pada jumlah tugas dalam antrian dan status layanan. Tunggu hingga hasil selesai.
SDK Python
Tetapkan base_http_api_url berdasarkan wilayah layanan:
- Singapura
- China (Beijing)
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Segera unduh video tersebut.
SDK Java
Tetapkan Constants.baseHttpApiUrl berdasarkan wilayah layanan:
- Singapura
- China (Beijing)
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} dengan ID ruang kerja aktual Anda.
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
video_url berlaku selama 24 jam. Segera unduh video tersebut.