Skip to main content
AnimateAnyone: Hasilkan video tari dari gambar

Referensi API pembuatan templat aksi AnimateAnyone

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

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
  • 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

  • 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.
  • 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/
  • 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.

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.
Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model