API pembuatan templat aksi AnimateAnyone - Alibaba Cloud Model Studio

Model ini mengekstraksi gerakan karakter dari video untuk menghasilkan templat aksi bagi AnimateAnyone. Topik ini menjelaskan API pembuatan templat tersebut.

Penting

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

Ikhtisar model

Model	Deskripsi
animate-anyone-template-gen2	Mengekstraksi gerakan karakter dari video gerak untuk menghasilkan templat aksi karakter.

Contoh

Contoh yang benar

Contoh video yang memenuhi persyaratan untuk membuat templat aksi

Catatan

Orang tersebut harus terlihat secara utuh dengan wajah yang jelas dan tidak ada bagian tubuh yang terhalang.
Orang tersebut harus muncul sejak frame pertama. Aksi harus berkelanjutan (satu kali pengambilan). Pisahkan video yang memiliki perubahan adegan menjadi klip terpisah.
Untuk hasil terbaik, orang tersebut sebaiknya menghadap kamera pada frame pertama. Hindari membungkuk, jongkok, atau posisi merunduk berlebihan.

Contoh yang salah

Postur melengkung dan self-occlusion

Beberapa orang dalam frame

Orang buram

Orang terlalu kecil

(Wajah tidak jelas)

Orang terlalu besar

(Orang tidak terlihat secara utuh)

Body occlusion

Multiple people

f3e2df6643d44db7a7d65d4571609bff_3 (1)

Person too small

Person too large

Catatan

Periksa bahwa tidak ada frame yang mengandung kesalahan seperti di atas untuk memastikan kualitas templat.
Jika bingkai pertama berisi kesalahan sebelumnya, tugas tersebut dapat gagal.

Penting

Pastikan file video yang diunggah mematuhi peraturan dan undang-undang yang berlaku.
Templat yang dihasilkan mempertahankan audio dari video yang diunggah. Jika Anda tidak menginginkan audio tersebut atau tidak memiliki lisensi untuknya (misalnya musik latar), hapus audio sebelum mengunggah.

HTTP

Deskripsi fitur

Menghasilkan templat aksi karakter untuk digunakan dengan API pembuatan video AnimateAnyone guna membuat video karakter.

Prasyarat

Anda telah mengaktifkan Alibaba Cloud Model Studio dan membuat API key. Untuk informasi selengkapnya, lihat Mendapatkan API key.

Batas input

Format video: MP4, AVI, atau MOV.
Ukuran file video tidak boleh melebihi 200 MB.
Dimensi video harus antara 200–2.048 piksel per sisi. Laju frame minimal 24 fps. Pengkodean harus H.264 atau H.265.
Durasi video harus antara 2 detik hingga 60 detik.
Rasio aspek video harus antara 1:3 dan 3:1.
Hanya URL HTTP yang didukung. Jalur file lokal tidak didukung.

Langkah 1: Buat tugas dan dapatkan ID tugas

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/

Catatan

Pemanggilan API ini memakan waktu dan dijalankan secara asinkron.
Setelah dikirim, sistem mengembalikan ID tugas untuk menanyakan status dan hasil.

Parameter permintaan

Field	Type	Location	Required	Description	Example
Content-Type	String	Header	Yes	Format body permintaan.	application/json
Authorization	String	Header	Yes	Kunci API Anda dengan awalan `Bearer` .	Bearer d1**2a
X-DashScope-Async	String	Header	Yes	Atur ke `enable` untuk pengiriman tugas asinkron.	enable
model	String	Body	Yes	Model yang akan digunakan.	animate-anyone-template-gen2
input.video_url	String	Body	No	URL video untuk menghasilkan templat aksi. Ukuran file video tidak boleh melebihi 200 MB. Panjang setiap sisi video harus antara 200 dan 2.048 piksel. Laju frame video harus 24 fps atau lebih tinggi. Video harus dikodekan dalam H.264 atau H.265. Durasi video harus antara 2 detik hingga 60 detik. Rasio aspek video harus antara 1:3 dan 3:1. Format video yang didukung: MP4, AVI, dan MOV. Catatan Unggahan file hanya mendukung tautan HTTP atau HTTPS. Jalur file lokal tidak didukung.	http://aaa/bbb.mp4

Parameter respons

Field	Type	Description	Example
output.task_id	String	ID tugas yang dikirimkan. Gunakan ID ini untuk menanyakan hasil tugas.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas setelah dikirim.	"PENDING"
request_id	String	Identifier unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "animate-anyone-template-gen2",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241210/cwjmsz/1.mp4"
    }
  }'

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 tugas

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

Parameter permintaan

Field	Type	Location	Required	Description	Example
Authorization	String	Header	Yes	Kunci API Anda dengan awalan `Bearer` .	Bearer d1**2a
task_id	String	URL Path	Yes	ID tugas yang akan ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Field	Type	Description	Example
output.task_id	String	ID tugas yang ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas yang ditanyakan.	Status tugas: PENDING RUNNING SUCCEEDED FAILED UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui.
output.template_id	String	ID templat aksi yang dikembalikan oleh platform. Gunakan ID ini dengan API pembuatan video AnimateAnyone. ID ini diverifikasi izinnya: akun yang menggunakannya harus sama dengan akun yang menghasilkannya.	AACT.xxx.xxx-xxx.xxx
usage.video_duration	Float	Durasi templat yang dihasilkan, dalam detik.	"video_duration": 10.23
usage.video_ratio	String	Tipe rasio aspek templat yang dihasilkan. Nilai: `standard`.	"video_ratio": "standard"
request_id	String	Identifier unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>

Contoh respons

{
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
        "task_status": "SUCCEEDED",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "usage": {
        "video_duration": 10.23,
        "video_ratio": "standard"
    }
}

Contoh respons error

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

Langkah selanjutnya

Gunakan templat aksi untuk referensi API pembuatan video AnimateAnyone.

Kode error

Untuk kode status umum, lihat Kode error.