AnimateAnyone模型,可基于AnimateAnyone-template模型生成的動作模板,以及通過AnimateAnyone-detect模型檢測的人物圖像生成人物動作視頻。本文檔介紹了該模型提供的視頻生成能力的API調用方法。
模型概覽
模型名 | 模型簡介 |
animate-anyone-gen2 | animate-anyone-gen2是一個人物動作視頻生成模型,可基于人物圖片和人物動作模板生成人物動作視頻。 |
HTTP調用接口
功能描述
用于生成人物動作視頻。
前提條件
已開通服務并獲得API-KEY:獲取API Key。
輸入的動作模板由AnimateAnyone 動作模板生成API生成;
輸入的圖像已通過AnimateAnyone 圖像檢測API檢測。
輸入限制
圖像格式:格式為jpg、png、jpeg、bmp。
圖像要求:圖像文件<5M,寬高比≤2,最大邊長≤4096像素。
上傳的圖像文件支持HTTP鏈接,不支持本地路徑。也可使用平臺提供的文件存儲API,上傳本地文件并創建鏈接。
輸入圖像與視頻生成類型的適用關系:
輸入圖片
按圖片背景生成
(即use_ref_img_bg設為true)
按視頻背景生成
(即use_ref_img_bg設為false)
全身人像
支持
支持
半身人像
支持
不推薦
說明按視頻背景生成時,需將圖片中人像匹配到視頻中人像的對應位置。對于半身人像圖中未出現的區域(如腿部),模型將隨機生成補全,有較大不確定性,故不推薦在該條件下做視頻生成。
作業提交接口
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/
因該算法調用耗時較長,故采用異步調用的方式提交任務。
任務提交之后,系統會返回對應的作業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-gen2 |
input.image_url | String | Body | 是 | 用戶上傳的圖片 URL,該圖應先通過AnimateAnyone 圖像檢測API,并結合所需生成的畫幅進行適當裁剪。
說明 上傳圖片僅支持HTTP鏈接,不支持本地路徑。 | http://aaa/bbb.jpg |
input.template_id | String | Body | 是 | 動作模板ID,用于指明所需使用的動作模板。應輸入AnimateAnyone 動作模板生成API生成的template_id。 說明 動作模板ID會進行權限校驗,請確保所使用的template_id是由當前的云賬號創建得到的。 | AACT.xxx.xxx-xxx.xxx |
parameters.use_ref_img_bg | Boolean | Body | 否 | 生成視頻的背景控制,可設值為true或false。
| false |
parameters.video_ratio | String | Body | 否 | 選擇按圖片背景生成視頻時,可選畫幅為 "9:16"或"3:4",默認為"9:16"。 說明 選擇按視頻背景生成時,即use_ref_img_bg設false時,該參數不生效。將按模板視頻的比例生成新視頻。 說明 應確保輸入圖像的畫幅與所選畫幅一致,以避免生成視頻的畫面變形 | "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 --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": "http://xxx/1.jpg",
"template_id": "AACT.xxx.xxx-xxx.xxx"
},
"parameters": {
"use_ref_img_bg": false,
"video_ratio": "9:16"
}
}'
響應示例
{
"output": {
"task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
"task_status": "PENDING"
}
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}
作業任務狀態查詢和結果獲取接口
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 | 被查詢作業的作業狀態 | 任務狀態:
|
output.video_url | String | 平臺輸出的視頻結果,video_url有效期為作業完成后24小時 | https://xxx/1.mp4" |
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",
"video_url":"https://xxx/1.mp4"
},
"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",
}
}
狀態碼說明
大模型服務平臺通用狀態碼請查閱:錯誤碼。
本模型還有如下特定錯誤碼:
http 返回碼* | 錯誤碼(code) | 錯誤信息(message) | 含義說明 |
400 | InvalidURL.ConnectionRefused | Connection to ${url} refused, please provide available URL | 下載被拒絕,請提供可用的url |
400 | InvalidURL.Timeout | Download ${url} timeout, please check network connection. | 下載超時,10s超時 |
400 | InvalidFile.Size | Invalid file size, The image file size must be smaller than 5MB. | 圖片文件超過5M大小 |
400 | InvalidFile.Resolution | The image resolution is invalid, please make sure that the largest length of image is smaller than 4096, and the smallest length of image is larger than 224. | 上傳圖片大小不符合要求 |
400 | InvalidFile.AspectRatio | Invalid file ratio. The file aspect ratio (height/width) must be between 2.0 and 0.5 | 圖片文件寬高比必須在2.0到0.5之間 |
400 | InvalidFile.Template.Content | Invalid template content. | 動作模板無權限,或模板內容不符合要求。 |
400 | InvalidParameter | parameters.video_ratio must be 9:16 or 3:4 | video_ratio 入參只能為 9:16 或 3:4 |