跳转到主要内容
千问云 home page
开放平台文档
动作模板生成

AnimateAnyone 动作模板生成 — 创建任务

提交 AnimateAnyone 动作模板生成任务

POST
/services/aigc/image2video/aa-template-generation/
cURL - 创建动作模板
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "animate-anyone-template-gen2",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241210/cwjmsz/1.mp4"
    }
  }'
{
  "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
  "output": {
    "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
    "task_status": "PENDING"
  }
}
请先获取 API Key 并设置为环境变量。

模型信息

模型名模型简介
animate-anyone-template-gen2人物动作模板生成模型，可基于人物运动视频提取人物动作并制作模板

输入视频要求

上传的视频中人物应全身入镜、身体无遮挡、保持人脸清晰。人物应从画面首帧开始出现，动作连贯，一镜到底（有场景切换的视频建议拆分成多段）。建议画面首帧人物正面朝向镜头；避免人物运动中出现大幅弯腰、下蹲、身体蜷缩等动作。
为保障模板制作效果，应避免上传视频中的任一帧画面出现以下情况：身体蜷缩或遮挡、画面有多人、人物模糊、人物过小（人脸不清晰）、人物过大（人物不完整）。当视频首帧画面出现上述错误情形时，当次提交的任务可能报错并中止。
请确保上传的视频文件来源符合相关法律法规。生成的动作模板的音频与上传的视频文件中的音频一致。若不希望使用该音频，或尚未取得该音频（如音乐等）的使用许可，请在上传视频文件前消除其中的音频信息。

输入限制

  • 视频格式：支持 MP4、AVI、MOV。
  • 视频文件不大于 200 MB。
  • 视频边长不低于 200，不大于 2048 像素；长宽比介于 1:3 到 3:1。
  • 视频帧率 ≥ 24 fps，视频编码采用 H.264 或 H.265。
  • 视频时长不小于 2s 且不大于 60s。
  • 上传的视频文件支持 HTTP/HTTPS 链接，不支持本地路径。也可使用文件上传 API 上传本地文件并创建链接。

鉴权

​
string
header
必填

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

Header 参数

​
enum<string>
必填

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

可选值：enable

请求体

application/json
​
enum<string>
必填

指明需要调用的模型，此处用 animate-anyone-template-gen2。

可选值：animate-anyone-template-gen2
示例:animate-anyone-template-gen2
​
object

输入数据，包含用于动作模板提取的参考视频。

响应

200-application/json
​
string

本次请求的系统唯一码。

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