Parameter permintaan
|
Multi-image reference
Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Buat Kunci API
URL berikut ditujukan untuk wilayah Singapura. Untuk wilayah China (Beijing), gunakan URL ini sebagai gantinya: https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "image_reference",
"prompt": "In the video, a girl gracefully emerges from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops to look at the lush woods around her, a smile of surprise and joy blossoms on her face. This scene, frozen in an interplay of light and shadow, records her wonderful encounter with nature.",
"ref_images_url": [
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
},
"parameters": {
"prompt_extend": true,
"obj_or_bg": ["obj","bg"],
"size": "1280*720"
}
}'
Video repainting
Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Buat Kunci API
URL berikut ditujukan untuk wilayah Singapura. Untuk wilayah China (Beijing), gunakan URL ini sebagai gantinya: https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_repainting",
"prompt": "The video shows a black steampunk-style car driven by a gentleman, adorned with gears and copper pipes. The background is a steam-powered candy factory with retro elements, creating a vintage and fun scene.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"control_condition": "depth"
}
}'
Local editing
Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Buat Kunci API
URL berikut ditujukan untuk wilayah Singapura. Untuk wilayah China (Beijing), gunakan URL ini sebagai gantinya: https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_edit",
"prompt": "The video shows a Parisian-style French cafe where a lion in a suit elegantly sips coffee. It holds a coffee cup in one hand, taking a gentle sip with a relaxed expression. The cafe is tastefully decorated, with soft hues and warm lighting illuminating the lion's area.",
"mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
"video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
"mask_frame_id": 1
},
"parameters": {
"prompt_extend": false,
"mask_type": "tracking",
"expand_ratio": 0.05
}
}'
Video extension
Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Buat Kunci API
URL berikut ditujukan untuk wilayah Singapura. Untuk wilayah China (Beijing), gunakan URL ini sebagai gantinya: https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_extension",
"prompt": "A dog wearing sunglasses skateboarding on the street, 3D cartoon.",
"first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
},
"parameters": {
"prompt_extend": false
}
}'
Video outpainting
Kunci API untuk wilayah Singapura dan China (Beijing) berbeda. Buat Kunci API
URL berikut ditujukan untuk wilayah Singapura. Untuk wilayah China (Beijing), gunakan URL ini sebagai gantinya: https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_outpainting",
"prompt": "An elegant woman passionately plays the violin, with a full symphony orchestra behind her.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"top_scale": 1.5,
"bottom_scale": 1.5,
"left_scale": 1.5,
"right_scale": 1.5
}
}'
|
Multi-image reference
model string (Wajib)
Nama model. Contoh: wan2.1-vace-plus.
|
input object (Wajib)
Input dasar, seperti prompt.
Properti
prompt string (Wajib)
Menjelaskan elemen dan fitur visual yang ingin dimasukkan dalam video yang dihasilkan.
Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum adalah 800 karakter, di mana setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.
Untuk teknik prompt, lihat Panduan Prompt Text-to-Video/Image-to-Video.
function string (Wajib)
Nama fitur. Untuk multi-image reference, nilai parameter ini adalah image_reference.
Multi-image reference mendukung hingga 3 gambar referensi. Gambar-gambar tersebut dapat berisi entitas dan latar belakang, seperti manusia, hewan, pakaian, dan pemandangan. Gunakan prompt untuk menggambarkan konten video yang diinginkan, dan model akan menggabungkan beberapa gambar tersebut untuk menghasilkan konten video yang koheren.
ref_images_url array[string] (Wajib)
Array berisi URL gambar referensi.
-
URL publik:
Anda dapat memberikan 1 hingga 3 gambar referensi. Jika lebih dari 3, hanya 3 gambar pertama yang digunakan.
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi: Lebar dan tinggi harus berada dalam rentang [360, 2000] piksel.
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
Rekomendasi:
-
Saat menggunakan gambar referensi untuk entitas, kami menyarankan agar setiap gambar hanya berisi satu entitas. Latar belakang sebaiknya berwarna solid (misalnya putih) agar entitas lebih menonjol.
-
Jika menggunakan latar belakang dari gambar referensi, Anda dapat memberikan maksimal satu gambar latar belakang, yang tidak boleh mengandung objek entitas apa pun.
|
|
parameters object (Opsional)
Parameter untuk pemrosesan video, seperti pengaturan watermark.
Properti
obj_or_bg array[string] (Opsional)
Parameter ini digunakan untuk mengidentifikasi tujuan setiap gambar referensi dan berkorespondensi satu-ke-satu dengan parameter ref_images_url. Setiap elemen dalam array menentukan apakah gambar pada posisi yang bersangkutan merupakan 'subjek' atau 'latar belakang':
Catatan penggunaan:
-
Kami menyarankan Anda selalu menyertakan parameter ini, dan panjangnya harus sama dengan panjang ref_images_url, jika tidak akan muncul error.
-
Parameter ini dapat diabaikan dan secara default bernilai ["obj"] hanya jika ref_images_url berupa array dengan satu elemen.
Contoh: ["obj", "obj", "bg"].
size string (Opsional)
Resolusi video yang dihasilkan (lebar*tinggi). Model mendukung pembuatan video 720p. Nilai yang valid:
-
1280*720 (Default): Rasio aspek video adalah 16:9, dengan lebar 1280 dan tinggi 720.
-
720*1280: Rasio aspek video adalah 9:16.
-
960*960: Rasio aspek video adalah 1:1.
-
832*1088: Rasio aspek video adalah 3:4.
-
1088*832: Rasio aspek video adalah 4:3.
duration integer (Opsional)
Durasi video yang dihasilkan dalam detik. Nilai ini tetap pada 5.
prompt_extend bool (Opsional)
Menentukan apakah akan mengaktifkan penulisan ulang prompt. Jika diaktifkan, model bahasa besar (LLM) akan menulis ulang prompt input. Hal ini dapat meningkatkan hasil secara signifikan untuk prompt pendek, tetapi memperpanjang waktu pemrosesan.
seed integer (Opsional)
Bilangan acak seed mengontrol tingkat keacakan konten yang dihasilkan oleh model. Rentang nilai parameter seed adalah [0, 2147483647].
Jika Anda tidak menentukan seed, seed akan dibuat secara otomatis. Untuk hasil yang dapat direproduksi, gunakan nilai seed yang sama pada beberapa permintaan.
watermark bool (Opsional)
Menentukan apakah akan menambahkan watermark 'AI-generated' di pojok kanan bawah gambar.
|
Video repainting
model string (Wajib)
Nama model. Contoh: wan2.1-vace-plus.
|
input object (Wajib)
Input dasar, seperti prompt.
Properti
prompt string (Wajib)
Menjelaskan elemen dan fitur visual yang ingin dimasukkan dalam video yang dihasilkan.
Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum adalah 800 karakter, di mana setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.
Untuk teknik prompt, lihat Panduan Prompt Text-to-Video/Image-to-Video.
function string (Wajib)
Nama fitur. Untuk video repainting, nilai parameter ini adalah video_repainting.
Fitur video repainting mengekstraksi pose dan gerakan entitas, pencampuran aliran, kontur gerak, serta struktur garis dari video input. Fitur ini kemudian menggabungkannya dengan prompt teks untuk menghasilkan video baru dengan karakteristik dinamis yang sama. Fitur ini juga mendukung penggantian entitas dalam video asli dengan menggunakan gambar referensi, misalnya untuk mengubah penampilan karakter sambil mempertahankan gerakan aslinya.
video_url string (Wajib)
URL video input.
-
URL publik:
Persyaratan video:
-
Format: MP4.
-
Laju frame: 16 FPS atau lebih tinggi.
-
Ukuran: Maksimal 50 MB.
-
Durasi: Maksimal 5 detik. Video yang lebih panjang akan dipotong menjadi 5 detik pertama.
-
URL tidak boleh mengandung karakter Tionghoa.
Resolusi video output:
-
Jika resolusi video input 720p atau lebih rendah, resolusi output akan sama dengan input.
-
Jika resolusi video input lebih tinggi dari 720p, resolusi akan diturunkan agar sesuai dalam resolusi 720p sambil mempertahankan rasio aspek asli.
Durasi video output:
-
Durasi video output mengikuti durasi video input, hingga maksimal 5 detik.
-
Contoh: Jika video input berdurasi 3 detik, output juga berdurasi 3 detik. Jika input berdurasi 6 detik, output adalah 5 detik pertama dari input.
ref_images_url array[string] (Opsional)
Array berisi URL gambar referensi.
-
URL publik:
Hanya mendukung 1 gambar referensi. Kami menyarankan gambar ini berupa gambar entitas untuk mengganti konten entitas dalam video input.
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi: Lebar dan tinggi harus berada dalam rentang [360, 2000] piksel.
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
Rekomendasi:
|
|
parameters object (Wajib)
Parameter untuk pemrosesan video, seperti pengaturan watermark.
Properti
control_condition string (Wajib)
Metode ekstraksi fitur video.
-
posebodyface: Mengekstraksi ekspresi wajah dan gerakan tubuh entitas dari video input. Cocok untuk skenario di mana detail ekspresi wajah entitas perlu dipertahankan.
-
posebody: Mengekstraksi gerakan tubuh entitas dari video input, tanpa mempertimbangkan ekspresi wajah. Cocok untuk skenario di mana hanya gerakan tubuh entitas yang perlu dikontrol.
-
depth: Mengekstraksi pencampuran aliran dan kontur gerak dari video input.
-
scribble: Mengekstraksi struktur garis dari video input.
strength float (Opsional)
Menyesuaikan kekuatan kontrol metode ekstraksi fitur video yang ditentukan oleh parameter control_condition terhadap video yang dihasilkan.
Nilainya harus berada dalam rentang [0.0, 1.0]. Nilai default adalah 1.0.
Nilai yang lebih besar membuat video yang dihasilkan lebih mengikuti gerakan dan komposisi video asli. Nilai yang lebih kecil memberikan kebebasan kreatif yang lebih besar.
prompt_extend bool (Opsional)
Menentukan apakah akan mengaktifkan penulisan ulang prompt. Jika diaktifkan, model bahasa besar (LLM) akan menulis ulang prompt input. Hal ini dapat meningkatkan hasil secara signifikan untuk prompt pendek, tetapi memperpanjang waktu pemrosesan.
Jika deskripsi teks tidak konsisten dengan konten video, model mungkin salah menginterpretasi input. Kami menyarankan Anda menonaktifkan ekspansi cerdas secara manual dan memberikan deskripsi adegan yang jelas dan spesifik dalam prompt untuk meningkatkan konsistensi dan akurasi.
seed integer (Opsional)
Bilangan acak seed mengontrol tingkat keacakan konten yang dihasilkan oleh model. Rentang nilai parameter seed adalah [0, 2147483647].
Jika Anda tidak menentukan seed, seed akan dibuat secara otomatis. Untuk hasil yang dapat direproduksi, gunakan nilai seed yang sama pada beberapa permintaan.
watermark bool (Opsional)
Menentukan apakah akan menambahkan watermark 'AI-generated' di pojok kanan bawah gambar.
|
Local editing
model string (Wajib)
Nama model. Contoh: wan2.1-vace-plus.
|
input object (Wajib)
Input dasar, seperti prompt.
Properti
prompt string (Wajib)
Menjelaskan elemen dan fitur visual yang ingin dimasukkan dalam video yang dihasilkan.
Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum adalah 800 karakter, di mana setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.
Untuk teknik prompt, lihat Panduan Prompt Text-to-Video/Image-to-Video.
function string (Wajib)
Nama fitur: Untuk local editing, nilai parameter ini adalah video_edit.
Fitur local editing memungkinkan Anda menambah, memodifikasi, atau menghapus elemen di area tertentu dari video input. Anda juga dapat mengganti entitas atau latar belakang di area pengeditan untuk pengeditan video detail halus.
video_url string (Wajib)
URL video input.
-
URL publik:
Persyaratan video:
-
Format: MP4.
-
Laju frame: 16 FPS atau lebih tinggi.
-
Ukuran: Maksimal 50 MB.
-
Durasi: Maksimal 5 detik. Video yang lebih panjang akan dipotong menjadi 5 detik pertama.
-
URL tidak boleh mengandung karakter Tionghoa.
Resolusi video output:
-
Jika resolusi video input 720p atau lebih rendah, resolusi output akan sama dengan input.
-
Jika resolusi video input lebih tinggi dari 720p, resolusi akan diturunkan agar sesuai dalam resolusi 720p sambil mempertahankan rasio aspek asli.
Durasi video output:
-
Durasi video output mengikuti durasi video input, hingga maksimal 5 detik.
-
Contoh: Jika video input berdurasi 3 detik, output juga berdurasi 3 detik. Jika input berdurasi 6 detik, output adalah 5 detik pertama dari input.
ref_images_url array[string] (Opsional)
Array berisi URL gambar referensi.
-
URL publik:
Saat ini hanya mendukung 1 gambar referensi. Gambar ini dapat digunakan sebagai entitas atau latar belakang untuk mengganti konten yang sesuai dalam video input.
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi: Lebar dan tinggi harus berada dalam rentang [360, 2000] piksel.
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
Rekomendasi:
-
Saat menggunakan gambar referensi untuk entitas, kami menyarankan agar gambar hanya berisi satu entitas. Latar belakang sebaiknya berwarna solid (misalnya putih) agar entitas lebih menonjol.
-
Jika menggunakan latar belakang dari gambar referensi, gambar latar belakang tersebut tidak boleh mengandung objek entitas apa pun.
mask_image_url string (Opsional)
URL gambar mask.
-
URL publik:
Parameter ini menentukan area pengeditan video. Anda dapat menentukan parameter ini atau parameter mask_video_url. Kami menyarankan Anda memprioritaskan parameter ini.
Dalam gambar mask, area putih (nilai piksel [255, 255, 255]) menentukan wilayah yang akan diedit, sedangkan area hitam (nilai piksel [0, 0, 0]) menentukan wilayah yang akan dipertahankan.
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi gambar: Harus sama dengan resolusi video input (video_url).
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
mask_frame_id integer (Opsional)
Parameter ini berlaku saat mask_image_url tidak kosong. Parameter ini menentukan ID frame dalam video tempat target mask muncul.
Nilai default adalah 1, yang menunjukkan frame pertama video.
Rentang nilainya adalah [1, max_frame_id], di mana max_frame_id = laju frame video input * durasi video input + 1.
Sebagai contoh, jika video input (video_url) memiliki laju frame 16 FPS (frame per detik) dan durasi 5 detik, jumlah total frame adalah 16 × 5 + 1 = 81. Oleh karena itu, max_frame_id = 81.
mask_video_url string (Opsional)
URL video mask.
-
URL publik:
Parameter ini digunakan untuk menentukan area pengeditan video. Anda harus menentukan parameter ini atau parameter mask_image_url.
Format video, laju frame, resolusi, dan panjang video mask harus identik dengan video input (video_url).
Dalam video mask, area putih (nilai piksel [255, 255, 255]) menentukan wilayah yang akan diedit, sedangkan area hitam (nilai piksel [0, 0, 0]) menentukan wilayah yang akan dipertahankan.
|
|
parameters object (Opsional)
Parameter untuk pemrosesan video, seperti pengaturan watermark.
Properti
control_condition string (Opsional)
Metode ekstraksi fitur video. Nilai default adalah "", yang berarti tidak ada fitur yang diekstraksi.
-
posebodyface: Mengekstraksi ekspresi wajah dan gerakan tubuh entitas dari video input. Cocok untuk skenario di mana wajah entitas menempati sebagian besar frame dan fiturnya terlihat jelas.
-
depth: Mengekstraksi pencampuran aliran dan kontur gerak dari video input.
mask_type string (Opsional)
Saat mask_image_url tidak kosong, parameter ini berlaku untuk menentukan perilaku area pengeditan.
-
tracking (Default): Area pengeditan mengikuti lintasan gerak objek target secara dinamis. Cocok untuk skenario di mana subjek bergerak.
-
fixed: Area pengeditan tetap dan tidak berubah mengikuti konten layar.
expand_ratio float (Opsional)
Saat mask_type bernilai tracking, parameter ini berlaku dan menentukan rasio perluasan area mask ke luar.
Nilainya harus berada dalam rentang [0.0, 1.0]. Nilai default adalah 0.05, yang direkomendasikan.
Nilai yang lebih kecil membuat area mask lebih pas mengikuti objek target, sedangkan nilai yang lebih besar memperluas area mask lebih jauh.
expand_mode string (Opsional)
Saat mask_type bernilai tracking, parameter ini berlaku dan menentukan bentuk area mask.
Algoritma akan menghasilkan video mask dengan bentuk yang sesuai dari gambar mask input, berdasarkan expand_mode yang dipilih. Nilai yang didukung adalah sebagai berikut:
-
hull (Default): Mode poligon. Mode ini menggunakan poligon untuk mengelilingi objek yang dimask.
-
bbox: Mode kotak pembatas. Mode ini menggunakan persegi panjang untuk mengelilingi objek yang dimask.
-
original: Mode asli, yang berusaha mempertahankan bentuk asli target mask.
size string (Opsional)
Resolusi video yang dihasilkan (lebar*tinggi). Model mendukung pembuatan video 720p. Nilai yang valid:
-
1280*720 (Default): Rasio aspek video adalah 16:9, dengan lebar 1280 dan tinggi 720.
-
720*1280: Rasio aspek video adalah 9:16.
-
960*960: Rasio aspek video adalah 1:1.
-
832*1088: Rasio aspek video adalah 3:4.
-
1088*832: Rasio aspek video adalah 4:3.
duration integer (Opsional)
Durasi video yang dihasilkan dalam detik. Nilai ini tetap pada 5.
prompt_extend bool (Opsional)
Menentukan apakah akan mengaktifkan penulisan ulang prompt. Jika diaktifkan, model bahasa besar (LLM) akan menulis ulang prompt input. Hal ini dapat meningkatkan hasil secara signifikan untuk prompt pendek, tetapi memperpanjang waktu pemrosesan.
Jika deskripsi teks tidak konsisten dengan konten video, model mungkin salah menginterpretasi input. Kami menyarankan Anda menonaktifkan ekspansi cerdas secara manual dan memberikan deskripsi adegan yang jelas dan spesifik dalam prompt untuk meningkatkan konsistensi dan akurasi.
seed integer (Opsional)
Bilangan acak seed mengontrol tingkat keacakan konten yang dihasilkan oleh model. Rentang nilai parameter seed adalah [0, 2147483647].
Jika Anda tidak menentukan seed, seed akan dibuat secara otomatis. Untuk hasil yang dapat direproduksi, gunakan nilai seed yang sama pada beberapa permintaan.
watermark bool (Opsional)
Menentukan apakah akan menambahkan watermark 'AI-generated' di pojok kanan bawah gambar.
|
Video extension
model string (Wajib)
Nama model. Contoh: wan2.1-vace-plus.
|
input object (Wajib)
Input dasar, seperti prompt.
Properti
prompt string (Wajib)
Menjelaskan elemen dan fitur visual yang ingin dimasukkan dalam video yang dihasilkan.
Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum adalah 800 karakter, di mana setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.
Untuk teknik prompt, lihat Panduan Prompt Text-to-Video/Image-to-Video.
function string (Wajib)
Nama fungsi. Untuk video extension, nilai parameter ini adalah video_extension.
Fitur video extension menghasilkan konten berkelanjutan dari gambar atau video. Fitur ini juga dapat mengekstraksi fitur dinamis, seperti gerakan dan pencampuran aliran, dari video referensi untuk membimbing pembuatan video dengan gerakan serupa.
Durasi total video yang dihasilkan adalah 5 detik. Ini adalah durasi output akhir, bukan penambahan 5 detik ke konten asli.
first_frame_url string (Opsional)
URL gambar frame pertama.
-
URL publik:
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi: Lebar dan tinggi harus berada dalam rentang [360, 2000] piksel.
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
last_frame_url string(Opsional)
URL gambar frame terakhir.
-
URL publik:
Persyaratan gambar:
-
Format: JPG, JPEG, PNG, BMP, TIFF, atau WEBP.
-
Resolusi: Lebar dan tinggi harus berada dalam rentang [360, 2000] piksel.
-
Ukuran: Maksimal 10 MB.
-
URL tidak boleh mengandung karakter Tionghoa.
first_clip_url string (Opsional)
URL klip video pertama.
-
URL publik:
Persyaratan video:
-
Format: MP4.
-
Laju bingkai video: Lebih besar atau sama dengan 16 FPS. Saat first_clip_url dan last_clip_url digunakan bersamaan, kami menyarankan kedua klip memiliki laju frame yang sama.
-
Ukuran: Maksimal 50 MB.
-
Panjang video: Video tidak boleh lebih panjang dari 3 detik. Jika lebih panjang, 3 detik pertama video akan digunakan. Jika Anda menentukan first_clip_url dan last_clip_url, durasi total kedua klip video tidak boleh melebihi 3 detik.
-
URL tidak boleh mengandung karakter Tionghoa.
Resolusi video output:
-
Jika resolusi video input 720p atau lebih rendah, resolusi output akan sama dengan input.
-
Jika resolusi video input lebih tinggi dari 720p, resolusi akan diturunkan agar sesuai dalam resolusi 720p sambil mempertahankan rasio aspek asli.
last_clip_url string(Opsional)
URL klip video terakhir.
-
URL publik:
Persyaratan video:
-
Format: MP4.
-
Laju bingkai video: 16 FPS atau lebih tinggi. Saat first_clip_url dan last_clip_url digunakan bersamaan, kami menyarankan kedua klip memiliki laju frame yang sama.
-
Ukuran: Maksimal 50 MB.
-
Durasi video: Durasi tidak boleh melebihi 3 detik. Jika video lebih panjang, hanya 3 detik pertama yang digunakan. Jika Anda menentukan first_clip_url dan last_clip_url, durasi gabungan keduanya tidak boleh melebihi 3 detik.
-
URL tidak boleh mengandung karakter Tionghoa.
Resolusi video output:
-
Jika resolusi video input 720p atau lebih rendah, resolusi output akan sama dengan input.
-
Jika resolusi video input lebih tinggi dari 720p, resolusi akan diturunkan agar sesuai dalam resolusi 720p sambil mempertahankan rasio aspek asli.
video_url string (Opsional)
URL video input.
-
URL publik:
Video ini terutama digunakan untuk mengekstraksi fitur gerak yang bekerja bersama parameter first_frame_url, last_frame_url, first_clip_url, dan last_clip_url untuk membimbing pembuatan video extended dengan performa gerak serupa.
Persyaratan video:
-
Format: MP4.
-
Laju frame: 16 FPS atau lebih tinggi, konsisten dengan klip sebelum dan sesudahnya.
-
Resolusi: Konsisten dengan frame dan klip sebelum dan sesudahnya.
-
Ukuran: Maksimal 50 MB.
-
Durasi: Maksimal 5 detik. Video yang lebih panjang akan dipotong menjadi 5 detik pertama.
-
URL tidak boleh mengandung karakter Tionghoa.
|
|
parameters object (Opsional)
Parameter untuk pemrosesan video, seperti pengaturan resolusi video output.
Properti
control_condition string (Opsional)
Metode ekstraksi fitur video. Parameter ini wajib jika video_url ditentukan. Nilai default adalah "", yang berarti tidak ada fitur yang diekstraksi.
duration integer (Opsional)
Durasi video yang dihasilkan dalam detik. Nilai ini tetap pada 5.
prompt_extend bool (Opsional)
Menentukan apakah akan mengaktifkan penulisan ulang prompt. Jika diaktifkan, model bahasa besar (LLM) akan menulis ulang prompt input. Hal ini dapat meningkatkan hasil secara signifikan untuk prompt pendek, tetapi memperpanjang waktu pemrosesan.
Jika deskripsi teks tidak konsisten dengan konten video, model mungkin salah menginterpretasi input. Kami menyarankan Anda menonaktifkan ekspansi cerdas secara manual dan memberikan deskripsi adegan yang jelas dan spesifik dalam prompt untuk meningkatkan konsistensi dan akurasi.
seed integer (Opsional)
Bilangan acak seed mengontrol tingkat keacakan konten yang dihasilkan oleh model. Rentang nilai parameter seed adalah [0, 2147483647].
Jika Anda tidak menentukan seed, seed akan dibuat secara otomatis. Untuk hasil yang dapat direproduksi, gunakan nilai seed yang sama pada beberapa permintaan.
watermark bool (Opsional)
Menentukan apakah akan menambahkan watermark 'AI-generated' di pojok kanan bawah gambar.
|
Video outpainting
model string (Wajib)
Nama model. Contoh: wan2.1-vace-plus.
|
input object (Wajib)
Input dasar, seperti prompt.
Properti
prompt string (Wajib)
Menjelaskan elemen dan fitur visual yang ingin dimasukkan dalam video yang dihasilkan.
Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum adalah 800 karakter, di mana setiap karakter Tionghoa atau huruf dihitung sebagai satu karakter. Teks yang melebihi batas ini akan dipotong secara otomatis.
Untuk teknik prompt, lihat Panduan Prompt Text-to-Video/Image-to-Video.
function string (Wajib)
Nama fitur. Untuk video outpainting, nilai parameter ini adalah video_outpainting.
Fitur video outpainting memperluas proporsi frame video ke arah atas, bawah, kiri, dan kanan secara proporsional.
video_url string (Wajib)
URL video input.
-
URL publik:
Persyaratan video:
-
Format: MP4.
-
Laju frame: 16 FPS atau lebih tinggi.
-
Ukuran: Maksimal 50 MB.
-
Durasi: Maksimal 5 detik. Video yang lebih panjang akan dipotong menjadi 5 detik pertama.
-
URL tidak boleh mengandung karakter Tionghoa.
Resolusi video output:
-
Jika resolusi video input 720p atau lebih rendah, resolusi output akan sama dengan input.
-
Jika resolusi video input lebih tinggi dari 720p, resolusi akan diturunkan agar sesuai dalam resolusi 720p sambil mempertahankan rasio aspek asli.
Durasi video output:
-
Durasi video output mengikuti durasi video input, hingga maksimal 5 detik.
-
Contoh: Jika video input berdurasi 3 detik, output juga berdurasi 3 detik. Jika input berdurasi 6 detik, output adalah 5 detik pertama dari input.
|
|
parameters object (Opsional)
Parameter untuk pemrosesan video, seperti pengaturan rasio perluasan.
Properti
top_scale float (Opsional)
Memusatkan frame video dan memperluasnya ke atas berdasarkan rasio yang ditentukan.
Nilainya harus berada dalam rentang [1.0, 2.0]. Nilai default adalah 1.0, yang berarti tidak ada perluasan.
bottom_scale float (Opsional)
Memusatkan frame video dan memperluasnya ke bawah berdasarkan rasio yang ditentukan.
Nilainya harus berada dalam rentang [1.0, 2.0]. Nilai default adalah 1.0, yang berarti tidak ada perluasan.
left_scale float (Opsional)
Memusatkan frame video dan memperluasnya ke kiri berdasarkan rasio yang ditentukan.
Nilainya harus berada dalam rentang [1.0, 2.0]. Nilai default adalah 1.0, yang berarti tidak ada perluasan.
right_scale float (Opsional)
Memusatkan frame video dan memperluasnya ke kanan berdasarkan rasio yang ditentukan.
Nilainya harus berada dalam rentang [1.0, 2.0]. Nilai default adalah 1.0, yang berarti tidak ada perluasan.
duration integer (Opsional)
Durasi video yang dihasilkan dalam detik. Nilai ini tetap pada 5.
prompt_extend bool (Opsional)
Menentukan apakah akan mengaktifkan penulisan ulang prompt. Jika diaktifkan, model bahasa besar (LLM) akan menulis ulang prompt input. Hal ini dapat meningkatkan hasil secara signifikan untuk prompt pendek, tetapi memperpanjang waktu pemrosesan.
Jika deskripsi teks tidak konsisten dengan konten video, model mungkin salah menginterpretasi input. Kami menyarankan Anda menonaktifkan ekspansi cerdas secara manual dan memberikan deskripsi adegan yang jelas dan spesifik dalam prompt untuk meningkatkan konsistensi dan akurasi.
seed integer (Opsional)
Bilangan acak seed mengontrol tingkat keacakan konten yang dihasilkan oleh model. Rentang nilai parameter seed adalah [0, 2147483647].
Jika Anda tidak menentukan seed, seed akan dibuat secara otomatis. Untuk hasil yang dapat direproduksi, gunakan nilai seed yang sama pada beberapa permintaan.
watermark bool (Opsional)
Menentukan apakah akan menambahkan watermark 'AI-generated' di pojok kanan bawah gambar.
|
|