aliyun-animate-anyone

name	aliyun-animate-anyone
description	Use when generating dance or motion-transfer videos with Alibaba Cloud Model Studio AnimateAnyone (`animate-anyone-gen2`) using a detected character image and an action template. Use when cloning motion from a dance/action video into a target character image.
version	1.0.0

Category: provider

Model Studio AnimateAnyone

Validation

mkdir -p output/aliyun-animate-anyone
python -m py_compile skills/ai/video/aliyun-animate-anyone/scripts/prepare_animate_anyone_request.py && echo "py_compile_ok" > output/aliyun-animate-anyone/validate.txt

Pass criteria: command exits 0 and output/aliyun-animate-anyone/validate.txt is generated.

Output And Evidence

• Save normalized request payloads, detection outputs, template IDs, and task polling snapshots under output/aliyun-animate-anyone/.
• Record whether the result should keep the reference image background or the source video background.

Use AnimateAnyone when the task needs motion transfer from a template video rather than plain talking-head animation.

Critical model names

Use these exact model strings:

• animate-anyone-detect-gen2
• animate-anyone-template-gen2
• animate-anyone-gen2

Selection guidance:

• Run image detection first.
• Run template generation on the source motion video.
• Use animate-anyone-gen2 for the final video job.

Prerequisites

• China mainland (Beijing) only.
• Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.
• Input files must be public HTTP/HTTPS URLs.

Normalized interface (video.animate_anyone)

Detect Request

• model (string, optional): default animate-anyone-detect-gen2
• image_url (string, required)

Template Request

• model (string, optional): default animate-anyone-template-gen2
• video_url (string, required)

Generate Request

• model (string, optional): default animate-anyone-gen2
• image_url (string, required)
• template_id (string, required)
• use_ref_img_bg (bool, optional): whether to keep the input image background

Response

• task_id (string)
• task_status (string)
• video_url (string, when finished)

Quick start

python skills/ai/video/aliyun-animate-anyone/scripts/prepare_animate_anyone_request.py \
  --image-url "https://example.com/dancer.png" \
  --template-id "tmpl_xxx" \
  --use-ref-img-bg

Operational guidance

• The action template must come from the official template-generation API.
• Full-body images work best when use_ref_img_bg=false; half-body images are not recommended in that mode.
• This skill is best for dancing or large body motion transfer, not generic talking-head tasks.

Output location

• Default output: output/aliyun-animate-anyone/request.json
• Override base dir with OUTPUT_DIR.

References

• references/sources.md