/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`