aliyun-animate-anyone

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Category: provider
Category: provider

Model Studio AnimateAnyone

Model Studio AnimateAnyone

Validation

验证

bash
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.
bash
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
通过标准:命令退出码为0,且
output/aliyun-animate-anyone/validate.txt
文件已生成。

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.
  • 将标准化请求负载、检测输出、模板ID、任务轮询快照保存到
    output/aliyun-animate-anyone/
    目录下。
  • 记录结果是保留参考图像背景还是源视频背景。
当任务需要从模板视频迁移动作,而非简单的说话人头部动画时,请使用AnimateAnyone。

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.
使用以下精确的模型字符串:
  • animate-anyone-detect-gen2
  • animate-anyone-template-gen2
  • animate-anyone-gen2
选型指南:
  • 首先运行图像检测。
  • 对源动作视频运行模板生成。
  • 最终视频生成任务使用
    animate-anyone-gen2
    模型。

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.
  • 仅支持中国大陆(北京)区域使用。
  • 在环境变量中配置
    DASHSCOPE_API_KEY
    ,或者将
    dashscope_api_key
    添加到
    ~/.alibabacloud/credentials
    文件中。
  • 输入文件必须是公开的HTTP/HTTPS链接。

Normalized interface (video.animate_anyone)

标准化接口(video.animate_anyone)

Detect Request

检测请求

  • model
    (string, optional): default
    animate-anyone-detect-gen2
  • image_url
    (string, required)
  • model
    (字符串,可选):默认值为
    animate-anyone-detect-gen2
  • image_url
    (字符串,必填)

Template Request

模板请求

  • model
    (string, optional): default
    animate-anyone-template-gen2
  • video_url
    (string, required)
  • model
    (字符串,可选):默认值为
    animate-anyone-template-gen2
  • video_url
    (字符串,必填)

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
  • model
    (字符串,可选):默认值为
    animate-anyone-gen2
  • image_url
    (字符串,必填)
  • template_id
    (字符串,必填)
  • use_ref_img_bg
    (布尔值,可选):是否保留输入图像的背景

Response

返回结果

  • task_id
    (string)
  • task_status
    (string)
  • video_url
    (string, when finished)
  • task_id
    (字符串)
  • task_status
    (字符串)
  • video_url
    (字符串,任务完成时返回)

Quick start

快速开始

bash
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
bash
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.
  • 动作模板必须来自官方模板生成API。
  • use_ref_img_bg=false
    时,全身图像效果最佳;该模式下不推荐使用半身图像。
  • 该工具最适合舞蹈或大幅度肢体动作迁移,不适用于通用的说话人头部动画任务。

Output location

输出位置

  • Default output:
    output/aliyun-animate-anyone/request.json
  • Override base dir with
    OUTPUT_DIR
    .
  • 默认输出路径:
    output/aliyun-animate-anyone/request.json
  • 可通过环境变量
    OUTPUT_DIR
    覆盖基础输出目录。

References

参考资料

  • references/sources.md
  • references/sources.md