AnimateAnyone: Generate dance videos from images
AnimateAnyone image detection API reference
Check whether an input image is suitable for AnimateAnyone video generation using the detection API.
This document applies only to the China (Beijing) region. To use models, you must use an API key from the China (Beijing) region.
Model overview
Model
Description
animate-anyone-detect-gen2
Checks whether an input image is suitable for the animate-anyone-gen2 model.
Examples
Passing examples
Full-body shot
Half-body shot
Failing examples
Side view (Not facing forward)
Poor lighting (Person is unclear)
Obstructions (Hands covered, holding objects)
Complex background
Multiple people
HTTP
Prerequisites
Request endpoint
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect
Request parameters
Field
Type
Location
Required
Description
Example
Content-Type
String
Header
Yes
Request format.
application/json
Authorization
String
Header
Yes
API key with Bearer prefix.
Bearer d1**2a
model
String
Body
Yes
Detection model name.
animate-anyone-detect-gen2
input.image_url
String
Body
Yes
Image URL to check (must be publicly accessible via HTTP/HTTPS).
"image_url": "http://a/a.jpg"
Response parameters
Field
Type
Description
Example
output.check_pass
Boolean
Image passed detection.
true
output.bodystyle
String
Detected body style:
half (half-body shot)
full (full-body shot).
half
output.reason
String
Detection failure reason (returned only when check_pass is false).
The input image has no human body...
usage.image_count
Integer
Images checked.
1
request_id
String
Request identifier.
7574ee8f-38a3-4b1e-9280-11c33ab46e51
Request example
curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY " \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "animate-anyone-detect-gen2",
"input": {
"image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png"
}
}'
Successful response examples
Image passes detection
{
"output" : {
"bodystyle" : "full" ,
"check_pass" : true
},
"usage" : {
"image_count" : 1
},
"request_id" : "76df937d-6eb6-40aa-9ccf-xxxxxx"
}
Image fails detection
{
"output" :{
"check_pass" : false ,
"reason" : "The input image has no human body. Upload another image that contains a single person." ,
"bodystyle" : ""
},
"usage" :{
"image_count" : 1
},
"request_id" : "c56f62df-724e-9c19-96bd-xxxxxx"
}
Failed request example
{
"code" : "InvalidApiKey" ,
"message" : "No API-key provided." ,
"request_id" : "7438d53d-6eb8-4596-8835-xxxxxx"
}
What to do next
After detection passes, use the image for AnimateAnyone video generation .
Error codes
For a list of general status codes, see Error codes . AnimateAnyone action template generation API reference
This model extracts character movements from videos to generate action templates for AnimateAnyone. This topic describes the template generation API.