AnimateAnyone動作模板產生模型，可基於人物運動視頻提取人物動作，並產生可供AnimateAnyone視頻產生模型使用的人物動作模板。本文檔介紹了該模型提供的動作模板產生能力的API調用方法。
本文檔僅適用於“中國大陸（北京）”地區。如需使用模型，需使用“中國大陸（北京）”地區的API Key。
模型概覽
模型名 | 模型簡介 |
animate-anyone-template-gen2 | animate-anyone-template-gen2是一個人物動作模板產生模型，可基於人物運動視頻提取人物動作並製作模板。 |
模型輸入要求
正確樣本：
符合動作模板製作要求的視頻樣本 | |
上傳的視頻中人物應全身入鏡、身體無遮擋、保持人臉清晰。
人物應從畫面首幀開始出現，動作連貫，一鏡到底（有情境切換的視頻建議拆分成多段）。
建議：畫面首幀人物正面朝向鏡頭；避免人物運動中出現大幅彎腰、下蹲、身體蜷縮等動作。
錯誤樣本：
身體蜷縮、遮擋 | 畫面有多人 | 人物模糊 | 人物過小 （人臉不清晰） | 人物過大 （人物不完整） |
|
|
|
|
|
為保障模板製作效果，應避免上傳視頻中的任一幀畫面出現上述錯誤情形。
當視頻首幀畫面出現上述錯誤情形時，當次提交的任務可能報錯並中止。
請確保上傳的視頻檔案來源符合相關法律法規。
產生的動作模板的音頻，與上傳的視頻檔案中的音頻一致。若不希望使用該音頻，或尚未取得該音頻（如音樂等）的使用許可，請在上傳視頻檔案前，消除其中的音頻資訊。
HTTP調用介面
功能描述
用於產生人物動作模板，該模板可作AnimateAnyone 視頻產生 API的輸入物，以產生人物動作視頻。
前提條件
已開通服務並獲得API-KEY：擷取與配置 API Key。
輸入限制
視頻格式：支援mp4、avi、mov。
視頻檔案不大於200MB。
視頻邊長不低於200，不大於2048；視訊框架率≥24fps，視頻編碼採用H.264或H.265。
視頻時間長度不小於2s且不大於60s。
視頻長寬比介於1:3到3:1。
上傳的視頻檔案支援HTTP連結，不支援本地路徑。
步驟1：建立任務擷取任務ID
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/因該演算法調用耗時較長，故採用非同步呼叫的方式提交任務。
任務提交之後，系統會返回對應的任務ID，後續可通過“根據任務ID查詢結果介面”擷取任務狀態及對應結果。
入參描述
欄位 | 類型 | 傳參方式 | 必選 | 描述 | 樣本值 |
Content-Type | String | Header | 是 | 請求類型：application/json | application/json |
Authorization | String | Header | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a |
X-DashScope-Async | String | Header | 是 | 使用 enable，表明使用非同步方式提交任務。 | enable |
model | String | Body | 是 | 指明需要調用的模型，此處用animate-anyone-template-gen2 | animate-anyone-template-gen2 |
input.video_url | String | Body | 否 | 使用者上傳的視頻 URL，用於產生基於指定視頻的動作模板。
說明 上傳檔案支援HTTP或HTTPS連結方式，不支援本地連結方式。 | http://aaa/bbb.mp4 |
出參描述：
欄位 | 類型 | 描述 | 樣本值 |
output.task_id | String | 提交非同步任務的任務 id，實際任務結果需要通過非同步任務查詢介面擷取 | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
output.task_status | String | 提交非同步任務後的 任務狀態 | “PENDING” |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求樣本
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"
}
}'響應樣本
{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
"task_status": "PENDING"
},
"request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx"
}步驟2：根據任務ID查詢結果
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}入參描述
欄位 | 類型 | 傳參方式 | 必選 | 描述 | 樣本值 |
Authorization | String | Header | 是 | API-Key，例如：Bearer d1**2a。 | Bearer d1**2a |
task_id | String | Url Path | 是 | 需要查詢任務的task_id。 | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
出參描述
欄位 | 類型 | 描述 | 樣本值 |
output.task_id | String | 查詢任務的 task_id | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
output.task_status | String | 被查詢任務的任務狀態 | 任務狀態： PENDING 排隊中 RUNNING 處理中 SUCCEEDED 成功 FAILED 失敗 UNKNOWN 任務不存在或狀態未知 |
output.template_id | String | 平台輸出的動作模板ID，可作為“Animate-Anyone 視頻產生介面”的入參。 動作模板ID會進行許可權校正，請確保使用template_id的雲帳號與當前生產該動作模板的雲帳號一致。 | AACT.xxx.xxx-xxx.xxx |
usage.video_duration | Float | 本次請求產生模板時間長度計量，單位：秒 | "video_duration": 10.23 |
usage.video_ratio | String | 本次請求產生視頻模板的畫幅類型，該值為standard | "video_ratio": "standard" |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求樣本
curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>響應樣本
{
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "SUCCEEDED",
"template_id": "AACT.xxx.xxx-xxx.xxx"
},
"usage": {
"video_duration": 10.23,
"video_ratio": "standard"
}
}異常響應樣本
{
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "FAILED",
"code": "xxx",
"message": "xxxxxx"
}
}狀態代碼說明
大模型服務平台通用狀態代碼請查閱：錯誤資訊。