API pembuatan templat aksi AnimateAnyone - Alibaba Cloud Model Studio

Model pembuatan templat aksi AnimateAnyone mengekstraksi gerakan karakter dari video referensi dan menghasilkan templat aksi karakter untuk digunakan pada model pembuatan video AnimateAnyone. Dokumen ini menjelaskan cara memanggil API untuk fitur pembuatan templat aksi 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	animate-anyone-template-gen2 adalah model yang menghasilkan templat aksi karakter. Model ini mengekstraksi gerakan karakter dari video gerak untuk membuat templat.

Persyaratan input

Contoh yang benar

Contoh video yang memenuhi persyaratan untuk membuat templat aksi

Catatan

Orang dalam video yang diunggah harus terlihat seluruhnya, dengan wajah jelas dan tanpa bagian tubuh yang terhalang.
Orang tersebut harus muncul sejak frame pertama video. Aksi harus berkelanjutan dan direkam dalam satu kali pengambilan. Pisahkan video yang memiliki perubahan adegan menjadi beberapa segmen.
Untuk hasil terbaik, orang tersebut sebaiknya menghadap kamera pada frame pertama. Hindari aksi seperti membungkuk berlebihan, jongkok, atau merunduk.

Contoh yang salah

Postur melengkung dan oklusi diri

Beberapa orang dalam frame

Orang buram

Orang terlalu kecil

(Wajah tidak jelas)

Orang terlalu besar

(Orang tidak terlihat seluruhnya)

身体遮挡@3x

多人物@3x

f3e2df6643d44db7a7d65d4571609bff_3 (1)

人物过小@3x

人物过大@3x

Catatan

Untuk memastikan kualitas templat yang dihasilkan, pastikan tidak ada frame dalam video yang diunggah mengandung kesalahan seperti di atas.
Jika frame pertama video mengandung salah satu kesalahan di atas, tugas yang dikirimkan dapat gagal dan dibatalkan.

Penting

Pastikan sumber file video yang diunggah mematuhi peraturan dan undang-undang yang berlaku.
Audio pada templat aksi yang dihasilkan sama dengan audio dalam file video yang diunggah. Jika Anda tidak ingin menggunakan audio tersebut, atau belum mendapatkan lisensi untuknya—misalnya musik latar—hapus audio dari file video sebelum mengunggahnya.

HTTP

Deskripsi fitur

Menghasilkan templat aksi karakter. Templat ini dapat digunakan sebagai input untuk API pembuatan video AnimateAnyone guna menghasilkan video aksi karakter.

Prasyarat

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

Batasan input

Format video: MP4, AVI, atau MOV.
Ukuran file video tidak boleh melebihi 200 MB.
Panjang setiap sisi video harus antara 200 hingga 2.048 piksel. Laju bingkai video harus 24 frame per detik (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.
Hanya URL HTTP yang didukung. Jalur file lokal tidak didukung.

Langkah 1: Buat tugas dan dapatkan ID tugas

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/

Catatan

Pemanggilan API ini memakan waktu. Oleh karena itu, tugas dikirimkan secara asinkron.
Setelah Anda mengirimkan tugas, sistem akan mengembalikan ID tugas. Anda kemudian dapat menggunakan ID tugas tersebut untuk menanyakan status dan hasil tugas.

Parameter permintaan

Field	Type	Parameter Passing	Required	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan: application/json	application/json
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer d1**2a	Bearer d1**2a
X-DashScope-Async	String	Header	Ya	Tetapkan nilai ke `enable` untuk mengirimkan tugas secara asinkron.	enable
model	String	Body	Ya	Model yang dipanggil. Tetapkan nilainya ke animate-anyone-template-gen2.	animate-anyone-template-gen2
input.video_url	String	Body	Tidak	URL video yang Anda unggah. Video ini digunakan untuk menghasilkan templat aksi. Ukuran file video tidak boleh melebihi 200 MB. Panjang setiap sisi video harus antara 200 hingga 2.048 piksel. Laju bingkai 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, bukan jalur file lokal.	http://aaa/bbb.mp4

Parameter respons

Field	Type	Deskripsi	Contoh
output.task_id	String	ID tugas asinkron yang dikirimkan. Hasil tugas sebenarnya harus diperoleh menggunakan API kueri tugas asinkron.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas setelah pengiriman.	"PENDING"
request_id	String	Pengidentifikasi unik untuk permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl --location 'https://dashscope.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://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Parameter permintaan

Field	Type	Parameter Passing	Required	Deskripsi	Contoh
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
task_id	String	URL Path	Ya	ID tugas yang akan ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Field	Type	Deskripsi	Contoh
output.task_id	String	ID tugas yang ditanyakan.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas yang ditanyakan.	Status tugas: PENDING: Tugas sedang dalam antrian. RUNNING: Tugas sedang berjalan. SUCCEEDED: Tugas berhasil. FAILED UNKNOWN: Tugas tidak ditemukan atau statusnya tidak diketahui.
output.template_id	String	ID templat aksi yang dikembalikan platform. ID ini dapat digunakan sebagai parameter permintaan untuk API pembuatan video Animate-Anyone. ID templat aksi diverifikasi berdasarkan izin. Pastikan Akun Alibaba Cloud yang menggunakan template_id sama dengan akun yang menghasilkan templat tersebut.	AACT.xxx.xxx-xxx.xxx
usage.video_duration	Float	Durasi templat yang dihasilkan untuk permintaan ini, dalam satuan detik.	"video_duration": 10.23
usage.video_ratio	String	Jenis rasio aspek templat video yang dihasilkan untuk permintaan ini. Nilainya adalah `standard`.	"video_ratio": "standard"
request_id	String	Pengidentifikasi unik untuk permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.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"
    }
}

Kode error

Untuk informasi tentang kode status umum, lihat Pesan error.