Buat animasi karakter AnimateAnyone melalui API - Model Studio

Model AnimateAnyone menghasilkan video aksi karakter berdasarkan templat aksi yang dibuat oleh model AnimateAnyone-template dan citra karakter yang dideteksi oleh model AnimateAnyone-detect. Dokumen ini menjelaskan cara memanggil API untuk fitur pembuatan video ini.

Penting

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

Ikhtisar model

Pengenalan model

Model	Deskripsi
animate-anyone-gen2	animate-anyone-gen2 adalah model pembuatan video aksi karakter. Model ini membuat video aksi karakter berdasarkan citra karakter dan templat aksi.

Contoh performa

Citra karakter	Templat aksi	Output (dihasilkan dengan latar belakang citra)	Output (dihasilkan dengan latar belakang video)

Catatan

Contoh di atas dihasilkan menggunakan Tongyi App, yang mengintegrasikan AnimateAnyone.
Anda dapat membuat templat aksi menggunakan API pembuatan templat aksi AnimateAnyone. Pastikan video sumber untuk templat aksi mematuhi peraturan dan undang-undang yang berlaku serta bahwa Anda memiliki hak penggunaan konten video tersebut, termasuk audionya.

HTTP

Deskripsi fitur

Menghasilkan video aksi karakter.

Prasyarat

Anda telah mengaktifkan Alibaba Cloud Model Studio dan membuat Kunci API. Untuk informasi selengkapnya, lihat Buat Kunci API.
Templat aksi input harus dihasilkan menggunakan API pembuatan templat aksi AnimateAnyone.
Citra input telah diproses oleh API Deteksi Citra AnimateAnyone.

Batasan input

Format citra: JPG, PNG, JPEG, atau BMP.
Persyaratan citra: ukuran file kurang dari 5 MB, rasio aspek tidak lebih dari 2, dan sisi terpanjang maksimal 4.096 piksel.
Anda harus menentukan file citra melalui URL HTTP karena path lokal tidak didukung. Untuk membuat URL untuk file lokal, unggah file tersebut ke ruang penyimpanan sementara yang disediakan oleh platform.

Persyaratan citra input untuk berbagai jenis pembuatan video:

Citra input

Hasilkan dengan latar belakang citra

(use_ref_img_bg diatur ke true)

Hasilkan dengan latar belakang video

(use_ref_img_bg diatur ke false)

Portrait tubuh penuh

Dukungan

Portrait setengah badan

Dukungan

Tidak disarankan

Catatan

Saat menghasilkan video dengan latar belakang video, posisi karakter dalam citra harus sesuai dengan posisi karakter dalam video. Jika Anda menggunakan citra portrait setengah badan, model akan menghasilkan bagian tubuh yang hilang (misalnya, kaki) secara acak, sehingga menimbulkan ketidakpastian signifikan. Oleh karena itu, kami tidak menyarankan pembuatan video dalam kondisi ini.

Langkah 1: Buat tugas dan dapatkan ID tugas

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

Catatan

Ini adalah panggilan API yang memakan waktu, sehingga Anda harus mengirimkan tugas secara asinkron.
Setelah mengirimkan tugas, sistem akan mengembalikan ID tugas. Anda dapat menggunakan ID ini untuk menanyakan status tugas dan mengambil hasilnya melalui API kueri hasil.

Parameter permintaan

Field	Type	Parameter Passing	Required	Description	Example
Content-Type	String	Header	Yes	Jenis permintaan: application/json.	application/json
Authorization	String	Header	Yes	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
X-DashScope-Async	String	Header	Yes	Atur nilainya ke enable untuk mengirimkan tugas secara asinkron.	enable
model	String	Body	Yes	Menentukan model yang akan dipanggil.	animate-anyone-gen2
input.image_url	String	Body	Yes	URL citra yang telah Anda unggah. Citra tersebut harus terlebih dahulu diproses oleh API deteksi citra AnimateAnyone dan dipotong sesuai kebutuhan untuk frame output yang diinginkan. Ukuran file citra harus kurang dari 5 MB. Rasio aspek harus 2 atau kurang. Sisi terpanjang harus 4096 piksel atau kurang. Format yang didukung: JPG, PNG, JPEG, dan BMP. Catatan Unggahan file hanya mendukung tautan HTTP atau HTTPS, bukan path file lokal.	http://aaa/bbb.jpg
input.template_id	String	Body	Yes	ID templat aksi. Ini menentukan templat aksi yang akan digunakan. Masukkan template_id yang dihasilkan oleh API pembuatan templat aksi AnimateAnyone. Catatan ID templat aksi menjalani verifikasi izin. Pastikan template_id yang Anda gunakan dibuat oleh Akun Alibaba Cloud Anda saat ini. Saran: Tingkatkan resolusi dan laju frame video templat untuk meningkatkan kualitas video yang dihasilkan.	AACT.xxx.xxx-xxx.xxx
parameters.use_ref_img_bg	Boolean	Body	No	Mengontrol latar belakang video yang dihasilkan. Nilainya dapat true atau false. Jika diatur ke true, video dihasilkan dengan latar belakang citra input. Jika diatur ke false, video dihasilkan dengan latar belakang video asli dari file templat. Nilai default adalah false.	false
parameters.video_ratio	String	Body	No	Saat Anda menghasilkan video dengan latar belakang citra, rasio aspek yang tersedia adalah "9:16" atau "3:4". Nilai default adalah "9:16". Catatan Parameter ini tidak berlaku saat Anda menghasilkan video dengan latar belakang video, yaitu ketika use_ref_img_bg diatur ke false. Video baru dihasilkan dengan rasio aspek video templat. Catatan Pastikan rasio aspek citra input sesuai dengan rasio aspek yang dipilih agar tidak terjadi distorsi pada video yang dihasilkan.	"9:16"

Parameter respons

Field	Type	Description	Example
output.task_id	String	ID tugas asinkron yang dikirimkan. Hasil tugas aktual harus diperoleh melalui API kueri tugas asinkron.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas setelah dikirimkan.	"PENDING"
request_id	String	Kode sistem unik untuk permintaan ini.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl --location '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": "animate-anyone-gen2",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "parameters": {
        "use_ref_img_bg": false,
        "video_ratio": "9:16"
    }
}'

Contoh respons

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

Langkah 2: Kueri hasil menggunakan ID tugas

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

Parameter permintaan

Field	Type	Parameter Passing	Required	Description	Example
Authorization	String	Header	Yes	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
task_id	String	Url Path	Yes	task_id dari tugas yang akan dikueri.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Field	Type	Description	Example
output.task_id	String	task_id dari tugas yang dikueri.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas yang dikueri.	Status tugas: PENDING PRE-PROCESSING RUNNING POST-PROCESSING SUCCEEDED FAILED UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui.
output.video_url	String	Hasil video yang dikeluarkan oleh platform. video_url berlaku selama 24 jam setelah tugas selesai.	https://xxx/1.mp4"
usage.video_duration	Float	Durasi video yang dihasilkan untuk permintaan ini, dalam satuan detik.	"video_duration": 10.23
usage.video_ratio	String	Jenis rasio aspek video yang dihasilkan untuk permintaan ini. Nilainya adalah standard.	"video_ratio": "standard"
request_id	String	Kode sistem unik untuk permintaan ini.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Contoh respons

{
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://xxx/1.mp4"
    },
    "usage": {
        "video_duration": 10.23,
        "video_ratio": "standard"
    }
}

Contoh respons error

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

Kode error

Untuk informasi tentang kode status umum, lihat Pesan error.