AnimateAnyone image detection API reference

Check whether an input image is suitable for AnimateAnyone video generation using the detection API.

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
A single person is visible from head to toe without obstructions. The person faces the camera without significant turning or tilting.	A single person is visible from the waist up without obstructions. The person faces the camera without significant turning or tilting.

Failing examples

Side view (Not facing forward)	Poor lighting (Person is unclear)	Obstructions (Hands covered, holding objects)	Complex background	Multiple people

HTTP

Prerequisites

• Activate the service and get an API key.

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.