AnimateAnyone — 创建任务

POST

/services/aigc/image2video/video-synthesis/

cURL - 创建视频生成任务

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "animate-anyone-gen2",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png",
    "template_id": "AACT.xxx.xxx-xxx.xxx"
  },
  "parameters": {
    "use_ref_img_bg": false,
    "video_ratio": "9:16"
  }
}'

{
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "output": {
    "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
    "task_status": "PENDING"
  }
}

根据人物图片和动作模板，生成角色动作视频。适用于舞蹈视频、肢体动作等场景。

前置准备

获取 API Key。
使用 AnimateAnyone 动作模板生成 API 生成动作模板，获取 template_id。
使用 AnimateAnyone 图像检测 API 验证人物图片是否符合要求，并按目标宽高比裁剪图片。

背景模式

通过 use_ref_img_bg 参数控制视频背景：

模式	`use_ref_img_bg`	说明
视频背景模式	`false`（默认）	使用模板视频的原始背景。
图片背景模式	`true`	使用输入图片作为视频背景，可通过 `video_ratio` 设置宽高比。

输入要求

人物图片（image_url）：

格式：JPG、PNG、JPEG 或 BMP
文件大小：不超过 5 MB
宽高比：不超过 2:1
最大边长：4096 像素

图片类型兼容性：

图片类型	图片背景模式	视频背景模式
全身照	支持	支持
半身照	支持	不推荐（模型会随机生成缺失部分，效果不可控）

使用视频背景模式时，建议使用全身照。半身照在视频背景模式下，模型会随机生成腿部等缺失区域，可能产生不可预期的效果。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

string

必填

请求类型：application/json。

示例:application/json

string

必填

千问云 API Key。详见获取 API Key。

示例:Bearer $DASHSCOPE_API_KEY

enum<string>

必填

使用 enable，表明使用异步方式提交任务。

可选值：enable

示例:enable

请求体

application/json

enum<string>

必填

指明需要调用的模型。

可选值：animate-anyone-gen2

示例:animate-anyone-gen2

object

必填

输入数据，包含人物图片和动作模板。

显示子属性

string

必填

用户上传的图片 URL，该图应先通过AnimateAnyone 图像检测API，并结合所需生成的画幅进行适当裁剪。

图像要求：

格式：JPG、PNG、JPEG 或 BMP
文件大小：＜5M
宽高比：≤2
最大边长：≤4096像素

**说明：**上传文件支持HTTP或HTTPS链接方式，不支持本地链接方式。您也可在此获取临时公网URL。

示例:http://aaa/bbb.jpg

string

必填

动作模板ID，用于指明所需使用的动作模板。应输入AnimateAnyone 动作模板生成API生成的template_id。

**说明：**动作模板ID会进行权限校验，请确保所使用的template_id是由当前的云账号创建得到的。

**使用建议：**提高模板视频的分辨率和帧率，可有效提升生成视频的画质效果。

示例:AACT.xxx.xxx-xxx.xxx

object

视频生成参数配置。

显示子属性

boolean

默认值false

生成视频的背景控制，可设值为true或false。

设true时将以输入图片的画面为背景生成视频（按图片背景生成）。
设false时将以模板文件的原视频画面为背景生成视频（按视频背景生成）。默认值为false。

**说明：**按视频背景生成时，需将图片中人像匹配到视频中人像的对应位置。对于半身人像图中未出现的区域（如腿部），模型将随机生成补全，有较大不确定性，故不推荐在该条件下做视频生成。

示例:false

enum<string>

默认值"9:16"

选择按图片背景生成视频时，可选画幅为 "9:16"或"3:4"，默认为"9:16"。

**说明：**选择按视频背景生成时，即use_ref_img_bg设false时，该参数不生效。将按模板视频的比例生成新视频。

**说明：**应确保输入图像的画幅与所选画幅一致，以避免生成视频的画面变形。

可选值：9:16,3:4

示例:9:16

响应

200-application/json

string

本次请求的系统唯一码。

示例:7574ee8f-38a3-4b1e-9280-11c33ab46e51

object

显示子属性

string

提交异步任务的任务ID，实际任务结果需要通过异步任务查询接口获取。

示例:a8532587-fa8c-4ef8-82be-0c46b17950d1

enum<string>

提交异步任务后的任务状态。

可选值：PENDING,PRE-PROCESSING,RUNNING,POST-PROCESSING,SUCCEEDED,FAILED,UNKNOWN

示例:PENDING

​前置准备

​背景模式

​输入要求

鉴权

Header 参数

请求体

响应

前置准备

背景模式

输入要求