全部产品
Search

搜索本产品

    Alibaba Cloud Model Studio：wan2.2-s2v referensi API pembuatan video

    文档中心

    Alibaba Cloud Model Studio：wan2.2-s2v referensi API pembuatan video

    更新时间：Oct 15, 2025

    Model manusia digital wan2.2-s2v dapat menghasilkan video seseorang yang berbicara, bernyanyi, atau melakukan aksi dengan gerakan alami dari gambar tunggal dan file audio.

    • Berbasis Audio: File audio masukan menggerakkan karakter dalam gambar statis, menyinkronkan gerakan bibir, ekspresi, dan aksinya dengan audio.

    • Skenario Kaya: Mendukung tiga skenario sinkronisasi bibir: "berbicara", "bernyanyi", dan "melakukan aksi".

    • Karakter Beragam: Mendukung orang sungguhan (potret, setengah badan, dan seluruh tubuh) serta karakter kartun.

    • Resolusi Video Keluaran: Mendukung opsi resolusi 480p dan 720p.

    Penting

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

    Model dan harga

    Wilayah Beijing

    Model

    Harga satuan

    Batas laju (dibagikan oleh Akun Alibaba Cloud dan Pengguna RAM)

    Batas RPS pengajuan tugas

    Jumlah tugas bersamaan

    wan2.2-s2v

    480P: $0,071677/detik

    720P: $0,129018/detik

    5

    1

    Klik untuk melihat contoh penagihan

    Rumus penagihan adalah: Total biaya = Durasi video aktual (detik) × Harga satuan resolusi yang dipilih.

    Misalkan Anda menghasilkan video dengan resolusi 480p, dan nilai `usage.video_duration` yang dikembalikan untuk tugas berhasil adalah 10,23 detik.

    Perhitungan biaya: 10,23 detik × $0,071677/detik = $0,73325571

    Catatan: Durasi yang dapat ditagih dihitung berdasarkan bidang `usage.video_duration` yang dikembalikan untuk tugas yang berhasil.

    API HTTP

    Prasyarat

    Langkah 1: Buat tugas dan dapatkan ID tugas

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

    • Karena pemanggilan model ini membutuhkan waktu lama, tugas dibuat melalui pemanggilan asinkron.

    • Setelah tugas dibuat, sistem segera mengembalikan task_id. Pada langkah berikutnya, gunakan `task_id` ini untuk menanyakan hasil tugas dalam jangka waktu 24 jam.

    Parameter permintaan

    Bidang

    Tipe

    Metode penerusan

    Diperlukan

    Deskripsi

    Contoh

    Content-Type

    String

    Header

    Ya

    Tipe permintaan. Atur nilainya menjadi application/json.

    application/json

    Authorization

    String

    Header

    Ya

    Kunci API. Formatnya adalah Bearer sk-xxx.

    Bearer sk-1a**2b

    X-DashScope-Async

    String

    Header

    Ya

    Bidang statis diatur ke `enable`, yang menunjukkan bahwa pemanggilan asinkron digunakan.

    enable

    model

    String

    Body

    Ya

    Model yang akan 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 dan 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 lingkungan 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 valid adalah 480P dan 720P. Nilai default adalah 480P.

    Model mencoba menjaga rasio aspek video keluaran sama dengan gambar masukan. Model menyesuaikan total piksel video agar mendekati level yang dipilih sambil menjaga rasio aspek tetap tidak berubah.

    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 masukan memiliki rasio aspek 4:5 dan Anda memilih level 480P, video keluaran akan mempertahankan rasio aspek 4:5. Resolusi akan disesuaikan agar mendekati 310.000 piksel. Sebagai contoh, resolusi video keluaran mungkin 480 × 600, dengan total 288.000 piksel. Data ini hanya untuk referensi. Keluaran aktual mungkin bervariasi.

    480P

    Parameter respons

    Bidang

    Tipe

    Deskripsi

    Contoh

    output.task_id

    String

    ID unik tugas asinkron.

    a8532587-fa8c-4ef8-82be-0c46b17950d1

    output.task_status

    String

    Status pekerjaan setelah tugas asinkron dikirimkan.

    PENDING

    request_id

    String

    ID unik permintaan.

    7574ee8f-38a3-4b1e-9280-11c33ab46e51

    Permintaan sampel

    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"
        }
    }'

    Respons sampel

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

    Langkah 2: Tanyakan hasil berdasarkan ID tugas

    Gunakan task_id dari langkah sebelumnya untuk mengirim permintaan GET guna memeriksa status dan hasil tugas. Ganti {task_id} di URL dengan ID tugas Anda yang sebenarnya.

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

    • Tugas pembuatan video membutuhkan waktu lama. Gunakan mekanisme polling dan atur interval pertanyaan yang wajar, seperti 10 detik, untuk mengambil hasil.

    • video_url yang dikembalikan untuk tugas berhasil berlaku selama 24 jam. Unduh dan simpan videonya segera.

    Parameter permintaan

    Bidang

    Tipe

    Metode penerusan

    Diperlukan

    Deskripsi

    Contoh

    Authorization

    String

    Header

    Ya

    Kunci API. Contoh: Bearer sk-xxx.

    Bearer sk-xxx

    task_id

    String

    Url Path

    Ya

    ID tugas yang akan ditanyakan.

    a8532587-fa8c-4ef8-82be-0c46b17950d1

    Parameter respons

    Bidang

    Tipe

    Deskripsi

    Contoh

    output.task_id

    String

    ID tugas yang ditanyakan.

    a8532587-fa8c-4ef8-82be-0c46b17950d1

    output.task_status

    String

    Status tugas. Nilai yang mungkin termasuk berikut ini:

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • UNKNOWN

    • CANCELED

    SUCCEEDED

    output.submit_time

    String

    Waktu pengajuan tugas.

    2025-09-01 09:37:27.468

    output.scheduled_time

    String

    Waktu tugas mulai berjalan.

    2025-09-01 09:37:34.885

    output.end_time

    String

    Waktu tugas 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 per detik.

    10,23

    usage.video_count

    Integer

    Jumlah video yang dihasilkan.

    1

    usage.SR

    Integer

    Tingkat resolusi video yang dihasilkan.

    480

    output.code

    String

    Kode kesalahan. Parameter ini dikembalikan ketika tugas gagal.

    InvalidParameter

    output.message

    String

    Detail kesalahan. Parameter ini dikembalikan ketika tugas gagal.

    Permintaan kehilangan parameter yang diperlukan atau dalam format yang salah

    request_id

    String

    ID unik permintaan.

    7574ee8f-38a3-4b1e-9280-11c33ab46e51

    Permintaan sampel

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

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

    Anda dapat menanyakan hasil tugas menggunakan `task_id` hanya dalam jangka waktu 24 jam. Setelah itu, hasilnya secara otomatis dihapus oleh sistem.

    Respons sampel

    Respons berhasil

    Data tugas, seperti status tugas dan URL video, disimpan hanya selama 24 jam. Setelah itu, data 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,
        "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 Batas laju

    Aturan Penagihan

    • Item yang Dapat Ditagih: Anda akan ditagih berdasarkan jumlah detik video yang berhasil dihasilkan menggunakan metode penagihan bayar sesuai pemakaian.

    • Rumus Penagihan: Biaya = Harga Satuan × Durasi Video (detik).

    • Prioritas Penagihan: Kuota gratis Anda akan digunakan terlebih dahulu. Setelah kuota gratis habis, metode penagihan bayar sesuai penggunaan akan diterapkan secara default.

      • Anda dapat mengaktifkan fitur "Hanya Kuota Gratis" untuk mencegah biaya tambahan setelah kuota gratis habis. Untuk informasi lebih lanjut, lihat Kuota Gratis untuk Pengguna Baru.

    • Tidak Ada Biaya untuk Kegagalan: Panggilan model yang gagal atau kesalahan pemrosesan tidak dikenakan biaya atau mengonsumsi kuota gratis.

    Kuota Gratis

    Untuk informasi lebih lanjut tentang cara mengklaim, menanyakan, dan menggunakan kuota gratis, lihat Kuota Gratis untuk Pengguna Baru.

    Memeriksa Penggunaan

    Sekitar satu jam setelah panggilan model selesai, Anda dapat mengunjungi halaman Observasi Model (Singapura) untuk melihat metrik seperti penggunaan, jumlah panggilan, dan tingkat keberhasilan.

    Jika model Anda berada di wilayah China (Beijing), kunjungi halaman Observasi Model.

    Pembatasan Laju

    Untuk aturan pembatasan laju model dan FAQ, lihat Batas Laju.

    Kode kesalahan

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