Alibaba Cloud Model Studio：Wan - referensi API gambar ke animasi

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

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

Langkah 1: Buat tugas dan dapatkan ID tugas

curl --location 'https://dashscope-intl.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-animate-move",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4",
        "watermark": true
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

Langkah 2: Kueri hasil berdasarkan ID tugas

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5.2,
        "video_ratio": "standard"
    }
}

{
    "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

wan2.2-animate-move menyediakan dua mode layanan, mode standar (wan-std) dan mode profesional (wan-pro), untuk memenuhi kebutuhan efek gambar-ke-animasi dalam berbagai skenario.

Aturan penagihan

• Metode penagihan: Layanan ini menggunakan metode penagihan pay-as-you-go. Anda dikenai biaya berdasarkan durasi (dalam detik) video yang berhasil dihasilkan. Durasi yang dikenai biaya adalah nilai bidang usage.video_duration dalam respons untuk tugas yang berhasil.

  Klik untuk melihat contoh penagihan

  Biaya dihitung setelah kuota gratis habis. Rumusnya: Total biaya = Durasi video aktual (dalam detik) × Harga satuan mode layanan yang dipilih.

  Asumsikan Anda memanggil model di wilayah Singapura untuk menghasilkan video, usage.video_duration yang dikembalikan untuk tugas yang berhasil adalah 5,2 detik, dan Anda memilih mode standar (wan-std).

  Biaya dihitung sebagai berikut: 5,2 detik × $0,12/detik = $0,624.

  Catatan: Durasi yang dikenai biaya akhir adalah nilai bidang usage.video_duration dalam respons untuk tugas yang berhasil.

• Urutan penggunaan kuota: Kuota gratis digunakan terlebih dahulu. Setelah kuota gratis habis, metode pay-as-you-go digunakan secara default. Anda dapat mengaktifkan fitur Cegah biaya berlebih untuk mencegah biaya tambahan setelah kuota gratis Anda habis. Untuk informasi selengkapnya, lihat Kuota gratis untuk pengguna baru.

• Tidak dikenai biaya untuk panggilan yang gagal: Jika panggilan model gagal atau terjadi kesalahan pemrosesan, tidak ada biaya yang dikenakan, dan kuota gratis Anda tidak dikonsumsi.

Pembatasan laju: Batas frekuensi permintaan total untuk Akun Alibaba Cloud dan Pengguna RAM-nya adalah 5 permintaan per detik. Maksimal 1 tugas dapat diproses sekaligus. Tugas baru yang melebihi batas ini akan ditambahkan ke antrian. Untuk informasi selengkapnya tentang aturan throttling model dan FAQ, lihat Batas laju.

T: Bagaimana cara melihat penggunaan model?

J: Informasi pemanggilan model mengalami penundaan sekitar satu jam. Sekitar satu jam setelah model dipanggil, Anda dapat membuka halaman Observasi Model (Singapura atau Beijing) untuk melihat metrik seperti volume panggilan, jumlah panggilan, dan tingkat keberhasilan. Untuk informasi selengkapnya, lihat Bagaimana cara melihat catatan panggilan model?

T: Bagaimana cara mengoptimalkan kualitas video yang dihasilkan?

A: Pertimbangkan rekomendasi berikut:

1. Pastikan orang tersebut menempati bagian frame yang serupa baik di gambar input maupun video referensi.

2. Usahakan agar proporsi tubuh orang tersebut konsisten antara gambar dan video.

3. Gunakan materi sumber berdefinisi tinggi. Hindari gambar buram atau video dengan laju frame rendah untuk memastikan pengenalan detail yang akurat.

T: Bagaimana cara mengonversi tautan video sementara menjadi permanen?

J: Anda tidak dapat mengonversi tautan secara langsung. Prosedur yang benar adalah layanan backend Anda mengunduh file video menggunakan URL tersebut, lalu mengunggahnya ke layanan penyimpanan objek permanen, seperti Alibaba Cloud OSS, untuk menghasilkan tautan akses permanen baru.

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # Setel timeout
        response.raise_for_status() # Jika kode status HTTP bukan 200, bangkitkan exception
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Video berhasil diunduh ke: {save_path}")
        # Anda dapat menambahkan logika untuk mengunggah ke penyimpanan permanen di sini
    except requests.exceptions.RequestException as e:
        print(f"Gagal mengunduh video: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

T: Apakah tautan video yang dikembalikan dapat diputar langsung di browser?

J: Hal ini tidak disarankan karena tautan kedaluwarsa setelah 24 jam. Praktik terbaik adalah backend Anda mengunduh dan menyimpan video, lalu menggunakan tautan permanen untuk pemutaran.