AnimateAnyone映像檢測模型，用於確認輸入的人物映像是否符合AnimateAnyone視頻產生模型的要求。本文檔介紹了該模型提供的映像檢測能力的API調用方法。
本文檔僅適用於“中國大陸（北京）”地區。如需使用模型，需使用“中國大陸（北京）”地區的API Key。
模型概覽
模型名 | 模型簡介 |
animate-anyone-detect-gen2 | animate-anyone-detect-gen2是一個映像檢測模型，專門用於檢測輸入的圖片是否滿足animate-anyone-gen2模型所需的人物映像規範。 |
效果樣本
人物映像檢測通過樣本
人物全身照 | 人物半身照 |
|
|
人物映像檢測不通過樣本
非正面照 （側身側臉） | 光線暗淡 （人物不清晰） | 人物遮擋 （服飾遮手、手持物品等） | 複雜背景 | 多人照片 |
|
|
|
|
|
HTTP調用介面
功能描述
該模型用於檢測輸入的圖片是否滿足“AnimateAnyone 視頻產生API”所需的人物圖片規範。
前提條件
已開通服務並獲得API-KEY：準備工作：擷取與配置 API Key。
作業提交介面調用
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect入參描述
欄位 | 類型 | 傳參方式 | 必選 | 描述 | 樣本值 |
Content-Type | String | Header | 是 | 請求類型：application/json | application/json |
Authorization | String | Header | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a |
model | String | Body | 是 | 指明需要調用的模型 | animate-anyone-detect-gen2 |
input.image_url | String | Body | 是 | 需要檢查的映像 URL URL 需為公網可訪問的地址，並支援 HTTP 或 HTTPS 協議。 | "image_url": "http://a/a.jpg" |
出參描述
欄位 | 類型 | 描述 | 樣本值 |
output.check_pass | Bool | 客戶提交的映像列表對應的檢查結果 | "check_pass":true/false |
output.bodystyle | String | 半身或全身：half 表示半身圖，full 代表全身圖 | "bodystyle": half/full |
output.reason | String | 客戶提交的映像列表對應的檢查結果原因 | |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
檢測不通過的原因
output.reason | 原因說明 |
The input image has no human body or multi human bodies. Please upload other image with single person. | 輸入圖片中沒有人或多人主體 |
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. | 上傳圖片大小不符合要求 |
The pose of the detected person is invalid, please upload other image with whole body and expected orientation. | 單人的動作不符合要求 （要求肩膀及踝部可見，非背身，非坐姿，人物朝向無嚴重位移） |
The pose of the detected face is invalid, please upload other image with whole face and expected orientation. | 單人的人臉不符合要求（要求面部可見，頭部朝向無嚴重位移） |
請求樣本
curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "animate-anyone-detect-gen2",
"input": {
"image_url":"http://xxx/1.jpg"
},
"parameters": {
}
}'響應樣本（通過）
{
"output":{
"check_pass": true,
"reason": 'success'
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}響應樣本（不通過）
{
"output":{
"check_pass": false,
"reason": "no human detect"
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}狀態代碼說明
大模型服務平台通用狀態代碼請查閱：錯誤資訊。
同時本模型還有如下特定錯誤碼：
http 返回碼* | 錯誤碼（code） | 錯誤資訊（message） | 含義說明 |
400 | InvalidParameter | Field required: xxx | 缺少入參，或格式錯誤 |
400 | InvalidURL | The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP. | 輸入圖片下載失敗，請檢查網路或者輸入格式 |
400 | InvalidFile.Content | The input image has no human body or multi human bodies. Please upload other image with single person. | 輸入圖片中沒有人或有多人 |
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.BodyPose | The pose of the detected person is invalid, please upload other image with whole body and expected orientation. | 單人的動作不符合要求 （要求肩膀及踝部可見，非背身，非坐姿，人物朝向無嚴重位移） |
400 | InvalidFile.FacePose | The pose of the detected face is invalid, please upload other image with whole face and expected orientation. | 單人的人臉不符合要求（要求面部可見，頭部朝向無嚴重位移） |