AnimateAnyone模型,可基于通過AnimateAnyone-detect模型檢測的人物圖像和預設動作模板生成視頻。本文檔介紹了該模型提供的視頻生成能力的API調用方法。
模型概覽
模型名 | 模型簡介 |
animate-anyone | animate-anyone是一個人物動作視頻生成模型,可基于人物圖片生成人物全身動作視頻。 |
HTTP調用接口
功能描述
用于生成人物動作視頻。因該算法調用耗時較長,故采用異步調用的方式提交任務。任務提交之后,系統會返回對應的作業 ID,后續可通過對應的異步作業查詢接口獲取任務狀態以及在作業結束后取回對應結果。
前提條件
已開通服務并獲得API-KEY:獲取API-KEY。
作業提交接口調用
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/
入參描述
字段 | 類型 | 傳參方式 | 必選 | 描述 | 示例值 |
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-xxx |
input.image_url | String | Body | 是 | 用戶上傳的參考圖片的原圖 URL, 圖片大小小于5M,圖像格式限于jpg/png/jpeg/bmp,長寬比小于等于2,最大邊長小于等4096. | http://aaa/bbb.jpg |
input.pose_sequence_id | String | Body | 否 | 預設動作序列ID: 目前僅僅支持dance,最終的動作序列會有更新 | 提供有權限的動作id,詳見文檔中的“預設動作模板”。例如:m_01_kemusan_v2_9s |
parameters.video_ratio | String | Body | 否 | 畫幅比例可選 "9:16"或"3:4" , 默認 "9:16"。 須確保輸入圖符合9:16或3:4,以避免變形。 | "9:16" |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 提交異步任務的作業 id,實際作業結果需要通過異步任務查詢接口獲取。 | a8532587-fa8c-4ef8-82be-0c46b17950d1 |
output.task_status | String | 提交異步任務后的 作業狀態。 | “PENDING” |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ,代碼才能正常運行。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "<YOUR_MODEL>",
"input": {
"image_url": "http://xxx/1.jpg",
"pose_sequence_id": "m_01_kemusan_v2_9s"
},
"parameters": {
"video_ratio": "9:16"
}
}'
響應示例
{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "PENDING"
}
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}
預設動作模板(pose_sequence_id)
以下為預設可供AnimateAnyone 視頻生成API調取的pose_sequence_id:
動作類型 | pose_sequence_id | 備注(舞蹈名稱) |
舞蹈 | m_01_kemusan_v2_9s | 科目三 |
舞蹈 | m_02_jilejingtu_9s | 極樂凈土 |
舞蹈 | m_04_aini_v2_8s | 愛你 |
舞蹈 | m_09_tuziwu_12s | 兔子舞 |
舞蹈 | m_11_niuyangge_6s | 扭秧歌 |
舞蹈 | m_13_liuliangmima_8s | 流量密碼 |
舞蹈 | m_16_mengguwu_5s | 蒙古舞 |
舞蹈 | m_18_shexiangfuren_9s | 奢香夫人 |
舞蹈 | m_19_yebuwu_6s | 曳步舞 |
舞蹈 | m_25_tianmeiwu_8s | 甜妹舞 |
舞蹈 | m_27_huajiangbu_v2_8s | 劃槳步 |
舞蹈 | m_28_xingganyao_8s | 性感扭扭 |
作業任務狀態查詢和結果獲取接口
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.results | Array | 如果作業成功,包含模型生成的結果 object,然后每個 object 中包含按照要求生成的結果地址 | {"url":"https://xxx/1.mp4"} |
usage.video_duration | Float | 本次請求生成視頻時長計量 | "video_duration": 2 |
usage.steps_ratio | Float | 本次請求 steps 參數的額外加成,比如客戶使用自定義 steps 值 30, 那么 steps_ration 的值為 30/20 = 1.5,steps 帶來的額外算力消費會在計費中體現。 | "steps_ratio": 1.5 |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ,代碼才能正常運行。
curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>
響應示例(作業成功執行完畢)
{
"output":{
"task_id":"a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status":"SUCCEEDED",
"results":
{
"video_url":"https://xxx/1.mp4"
}
},
"usage":{
"video_duration": 2
},
"request_id":"7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}
響應示例(作業失?。?/h3>{
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "FAILED",
"code": "xxx",
"message": "xxxxxx",
}
}
狀態碼說明
{
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "FAILED",
"code": "xxx",
"message": "xxxxxx",
}
}
大模型服務平臺通用狀態碼請查閱:狀態碼說明