Hasilkan Video Lip-Sync via wan2.2-s2v API - Model Studio

Model manusia digital wan2.2-s2v menghasilkan video seseorang yang berbicara, bernyanyi, atau tampil—dengan gerakan bibir, ekspresi wajah, dan aksi tubuh yang alami—berdasarkan satu gambar dan satu file audio.

Audio-driven: File audio input menggerakkan karakter dalam gambar statis, menyelaraskan gerakan bibir, ekspresi wajah, dan aksi tubuhnya dengan audio tersebut.
Skenario beragam: Mendukung tiga skenario lip-sync: berbicara, bernyanyi, dan tampil.
Karakter beragam: Mendukung orang sungguhan—termasuk potret, gambar setengah badan, dan gambar seluruh tubuh—serta karakter kartun.
Resolusi video output: Menyediakan opsi resolusi 480P dan 720P.

Penting

Dokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model ini, Anda harus menggunakan API key dari wilayah China (Beijing).

Model dan harga

Nama model

Harga satuan

Pembatasan laju (dibagi bersama oleh Akun Alibaba Cloud dan Pengguna RAM)

Batas RPS pengiriman task

Jumlah task konkuren

wan2.2-s2v

480P: $0,071677/detik

720P: $0,129018/detik

HTTP API

Prasyarat

Aktifkan layanan dan dapatkan API key.
Konfigurasikan variabel lingkungan: Konfigurasikan API key sebagai Variabel lingkungan (akan ditinggalkan dan digabung ke Konfigurasi API Key).

Langkah 1: Buat task dan dapatkan ID task

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Catatan

Karena pemanggilan model ini memerlukan waktu lama, task dibuat melalui pemanggilan asinkron.
Setelah task dibuat, sistem langsung mengembalikan task_id. Pada langkah berikutnya, gunakan task_id ini untuk menanyakan hasil task dalam waktu 24 jam.

Parameter permintaan

Field	Tipe	Metode Penerusan	Wajib	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan. Tetapkan nilainya ke application/json.	application/json
Authorization	String	Header	Ya	API key. Formatnya adalah Bearer sk-xxx.	Bearer sk-1a**2b
X-DashScope-Async	String	Header	Ya	Bidang statis yang diatur ke `enable`, yang menunjukkan bahwa pemanggilan asinkron digunakan.	enable
model	String	Body	Ya	Model yang dipanggil.	wan2.2-s2v
input.image_url	String	Body	Ya	URL gambar yang diunggah. Format gambar: JPG, JPEG, PNG, BMP, dan WEBP didukung. Resolusi gambar: Lebar dan tinggi gambar harus antara 400 hingga 7.000 piksel. Hanya tautan HTTP/HTTPS yang dapat diakses melalui Internet yang didukung.	http://aaa/bbb.jpg
input.audio_url	String	Body	Ya	URL file audio yang diunggah. Format audio: WAV dan MP3 didukung. Batas audio: Ukuran file harus kurang dari 15 MB, dan durasi harus kurang dari 20 detik. Konten audio: Audio harus berisi ucapan manusia yang jelas dan keras. Hilangkan gangguan seperti kebisingan ambient dan musik latar. Hanya tautan HTTP/HTTPS yang dapat diakses melalui Internet yang didukung.	http://aaa/bbb.mp3
parameters.resolution	String	Body	Tidak	Tingkat resolusi video. Nilai yang valid adalah 480P dan 720P. Nilai default adalah 480P. Model berusaha menjaga rasio aspek video output sama dengan gambar input. Model menyesuaikan total piksel video agar mendekati tingkat yang dipilih sambil mempertahankan rasio aspek tetap. Contoh 480P: Resolusi ini biasanya 640 × 480 (sekitar 310.000 piksel) dengan rasio aspek 4:3. 720P: Resolusi ini biasanya 1280 × 720 (sekitar 920.000 piksel) dengan rasio aspek 16:9. Contoh: Jika gambar input memiliki rasio aspek 4:5 dan Anda memilih tingkat 480P, video output akan mempertahankan rasio aspek 4:5. Resolusinya akan disesuaikan agar mendekati 310.000 piksel. Misalnya, resolusi video output mungkin 480 × 600, dengan total 288.000 piksel. Data ini hanya sebagai referensi. Output aktual dapat berbeda.	480P

Parameter respons

Field	Tipe	Deskripsi	Contoh
output.task_id	String	ID unik task asinkron.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status pekerjaan setelah task asinkron dikirim.	PENDING
request_id	String	ID unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
 --header 'X-DashScope-Async: enable' \
 --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
     "model": "wan2.2-s2v",
     "input": {
            "image_url": "https://img.alicdn.com/imgextra/i3/O1CN011FObkp1T7Ttowoq4F_!!6000000002335-0-tps-1440-1797.jpg",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/iaqpio/input_audio.MP3"
        },
        "parameters": {
            "resolution": "480P"
        }
    }'

Contoh respons

{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx", 
    	"task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx"
}

Langkah 2: Tanyakan hasil berdasarkan ID task

Kirim permintaan GET menggunakan task_id dari langkah sebelumnya untuk menanyakan status dan hasil task. Ganti {task_id} dalam URL dengan ID task yang sebenarnya.

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Catatan

Task generasi video dapat memerlukan waktu 5 hingga 10 menit untuk selesai. Anda dapat menggunakan mekanisme polling dan menetapkan interval penanyakan yang wajar, misalnya 15 detik, untuk mengambil hasilnya.
video_url yang dikembalikan untuk task yang berhasil berlaku selama 24 jam. Anda harus segera mengunduh dan menyimpan video tersebut.

Parameter permintaan

Field	Tipe	Metode Pengiriman Parameter	Wajib	Deskripsi	Contoh
Authorization	String	Header	Ya	API key. Contoh: Bearer sk-xxx.	Bearer sk-xxx
task_id	String	Url Path	Ya	ID task yang akan ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Field	Tipe	Deskripsi	Contoh
output.task_id	String	ID task yang ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status task. Nilai yang mungkin meliputi: PENDING: Task sedang dalam antrian. RUNNING: Task sedang diproses. SUCCEEDED FAILED: Task gagal. UNKNOWN: Pekerjaan tidak ada atau statusnya tidak diketahui. CANCELED: Task dibatalkan.	SUCCEEDED
output.submit_time	String	Waktu saat task dikirim.	2025-09-01 09:37:27.468
output.scheduled_time	String	Waktu saat task mulai dijalankan.	2025-09-01 09:37:34.885
output.end_time	String	Waktu saat task selesai.	2025-09-01 09:40:20.734
output.results.video_url	String	File video yang dihasilkan. video_url berlaku selama 24 jam. Unduh segera.	https://xxx/1.mp4?Expires=xxx
usage.duration	Float	Durasi video dalam detik. Ini digunakan untuk penagihan, yang dihitung per detik.	10,23
usage.video_count	Integer	Jumlah video yang dihasilkan.	1
usage.SR	Integer	Tingkat resolusi video yang dihasilkan.	480
usage.size	String	Resolusi video yang dihasilkan oleh permintaan.	"size": "640*480"
usage.fps	Integer	Laju frame video yang dihasilkan oleh permintaan.	"fps": 16
output.code	String	Kode kesalahan. Parameter ini dikembalikan jika task gagal.	InvalidParameter
output.message	String	Detail kesalahan. Parameter ini dikembalikan jika task gagal.	Permintaan kehilangan parameter yang diperlukan atau formatnya salah
request_id	String	ID unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan ID task yang sebenarnya.

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Catatan

Anda hanya dapat menanyakan hasil task menggunakan task_id dalam waktu 24 jam. Setelah periode ini, sistem secara otomatis melakukan purge terhadap hasil tersebut.

Contoh respons

Respons sukses

Data task, seperti status task dan URL video, hanya disimpan selama 24 jam lalu secara otomatis dihapus. Simpan hasilnya segera.

{
    "output": {
        "task_id": "bcae8761-f242-4775-a11e-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-01 09:37:27.468",
        "scheduled_time": "2025-09-01 09:37:34.885",
        "end_time": "2025-09-01 09:40:20.734",
        "results": {
            "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/1d/xxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "duration": 18.13,
        "size": "512*640",
        "fps": 16,
        "video_count": 1,
        "SR": 480
    },
    "request_id": "28cfedb1-cd60-9e0c-b920-xxxxxx"
}

Respons gagal

{
    "request_id": "8d49f522-f6a4-9eed-b322-xxxxxx",
    "output": {
        "task_id": "101ad32f-7653-4ae9-8f22-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2025-09-01 11:43:41.174",
        "scheduled_time": "2025-09-01 11:43:48.937",
        "end_time": "2025-09-01 11:43:49.802",
        "code": "InvalidURL",
        "message": "Required URL is missing or invalid, please check the request URL."
    }
}

Penagihan dan pembatasan laju

Untuk kuota gratis model dan harga satuan penagihan, lihat Wanxiang - Manusia Digital.
Untuk pembatasan laju model, lihat Seri Wanxiang.
Detail penagihan:
- Input tidak dikenai biaya; output ditagih berdasarkan jumlah detik video yang berhasil dihasilkan.
- Kegagalan pemanggilan model atau kesalahan pemrosesan tidak dikenai biaya atau mengurangi kuota gratis pengguna baru.

Kode kesalahan

Jika pemanggilan model gagal dan pesan kesalahan dikembalikan, lihat Pesan kesalahan.