Alibaba Cloud Model Studio:Referensi API image-to-action Wan

Buat animasi gambar karakter dengan mentransfer aksi dari video referensi.

• Rangkuman fitur: Transfer aksi dan ekspresi dari video referensi ke gambar karakter untuk menghasilkan video animasi.
• Skenario: Replikasi tarian, gerakan tubuh kompleks, dan ekspresi wajah dari pertunjukan film dan televisi. Alternatif berbiaya rendah dibandingkan motion capture.

Efek model

Model wan2.2-animate-move mendukung dua mode layanan: mode standar wan-std dan mode profesional wan-pro, yang berbeda dalam kualitas output dan harga. Untuk informasi lebih lanjut, lihat Wanx-Image-to-Motion.

Gambar karakter	Video referensi	Video output (mode standarwan-std)	Video output (mode profesionalwan-pro)

Prasyarat

Dapatkan Kunci API dan ekspor Kunci API sebagai variabel lingkungan.

HTTP

Pembuatan video menggunakan panggilan asinkron. Prosesnya terdiri dari dua langkah: buat tugas, lalu polling hasilnya.

Langkah 1: Buat tugas dan dapatkan ID tugas

Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Ganti {WorkspaceId} dengan ID Ruang Kerja aktual Anda.

Beijing: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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"
        }
      }'

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Langkah 2: Tanyakan hasil berdasarkan ID tugas

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.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"
    }
}

Batasan

Validitas data: ID tugas dan URL video kedaluwarsa setelah 24 jam. Unduh video segera.

Moderasi konten: Semua input dan output dimoderasi secara otomatis. Konten yang tidak sesuai mengembalikan error IPInfringementSuspect atau DataInspectionFailed. Untuk informasi lebih lanjut, lihat Kode kesalahan.

Penagihan dan pembatasan laju

• Untuk kuota gratis dan harga, lihat Wanx-Image-to-Motion.

• Untuk batas laju, lihat Seri Wan.

• Detail penagihan:

  • Hanya output yang ditagih, berdasarkan durasi video dalam satuan detik.
  • Panggilan yang gagal gratis dan tidak mengurangi kuota gratis pengguna baru.

Kode kesalahan

Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode kesalahan.

FAQ

Bagaimana cara meningkatkan kualitas video output?

1. Pastikan karakter menempati bagian frame yang serupa baik di gambar input maupun video referensi.
2. Jaga proporsi tubuh konsisten antara gambar dan video.
3. Gunakan materi sumber berdefinisi tinggi. Gambar buram atau video dengan laju frame rendah mengurangi kualitas output.

Bagaimana cara mengonversi tautan video sementara menjadi permanen?

Tautan tersebut tidak dapat dikonversi secara langsung. Unduh video dari backend Anda dan unggah ke penyimpanan objek permanen (seperti OSS) untuk mendapatkan URL permanen.

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # Atur 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)

Apakah saya bisa memutar langsung tautan video yang dikembalikan di browser?

Tidak disarankan. Tautan tersebut kedaluwarsa setelah 24 jam. Unduh dan simpan video dari backend Anda, lalu sajikan melalui tautan permanen.

Bagaimana cara mendapatkan daftar putih nama domain untuk penyimpanan video?

Jawaban: Video yang dihasilkan model disimpan di OSS. API mengembalikan URL publik sementara. Untuk mengonfigurasi daftar putih firewall bagi URL unduhan ini, perhatikan hal berikut: Penyimpanan dasar dapat berubah secara dinamis. Topik ini tidak menyediakan daftar putih nama domain OSS tetap untuk mencegah masalah akses akibat informasi yang kedaluwarsa. Jika Anda memiliki kebutuhan kontrol keamanan, hubungi manajer akun Anda untuk mendapatkan daftar nama domain OSS terbaru.