人物寫真生成API調用需“申請體驗”并通過后才可使用，否則API調用將返回錯誤狀態碼。
人物圖像檢測
支持的領域 / 任務：aigc /facechain人物寫真生成
對用戶上傳的人物圖像進行檢測，判斷其中所包含的人臉是否符合facechain微調所需的標準，檢測維度包括人臉數量、大小、角度、光照、清晰度等多維度，支持圖像組輸入，并返回每張圖像對應的檢測結果。
該模型非任務流程強制環節，可以根據業務需要自行選擇是否接入。
選擇圖像建議
人臉數量：1個人臉，不支持多人臉、不支持無人臉圖像；
人臉質量：建議為正面人臉，面部大于128*128像素，無墨鏡、手部等遮擋，不要有濃妝和過度美顏；
圖像質量：圖像分辨率大于256*256，小于4096*4096，文件大小不超過5MB，圖像清晰，沒有復雜的光線和陰影關系；
模型概覽
模型名 | 模型簡介 |
facechain-facedetect | 對用戶上傳的人物圖像進行檢測，判斷其中所包含的人臉是否符合facechain微調所需的標準，檢測維度包括人臉數量、大小、角度、光照、清晰度等多維度，支持圖像組輸入，并返回每張圖像對應的檢測結果。 |
HTTP調用接口
功能描述
本模型為同步接口，在提交任務后會返回對應的作業結果。
前提條件
已開通服務并獲得API-KEY：API-KEY的獲取與配置。
接口限制：對單賬戶（含主賬號與RAM子賬號）任務下發接口限制QPS為5。
作業提交接口調用
POST https://dashscope.aliyuncs.com/api/v1/services/vision/facedetection/detect
入參描述
傳參方式 | 字段 | 類型 | 必選 | 描述 | 示例值 |
Header | Content-Type | String | 是 | 請求類型：application/json | application/json |
Authorization | String | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a | |
Body | model | String | 是 | 指明需要調用的模型，固定值 | facechain-facedetect |
input.images | Array | 是 | 輸入的圖像 URL，分辨率不小于256*256，不超過4096*4096，文件大小不超過5MB, 支持格式包括JPEG, PNG, JPG, WEBP | "images": [ "http://a/a.jpg", "http://b/b.jpg", "http://c/c.jpg", ] |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.is_face | Array | 客戶提交的圖像列表對應的檢查結果 | "is_face":[ true, true, false, false ] |
request_id | String | 本次請求的系統唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運行。
curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/vision/facedetection/detect' \
--header 'Authorization: Bearer <your-dashscope-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "facechain-facedetect",
"input": {
"images": [
"http://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/zhicheng/tmp/1E1D5AFA-3C3A-4B6F-ABD6-8742CA983C42.png",
"http://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/zhicheng/tmp/3.JPG",
"http://finetune-swap-wulanchabu.oss-cn-wulanchabu.aliyuncs.com/zhicheng/tmp/F2EA3984-6EE2-44CD-928F-109B7276BCB6.png"
]
},
"parameters": {
}
}'響應示例
{
"output":{
"is_face":[
true,
true,
true
]
},
"usage":{
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}異常響應示例
在提交作業請求出錯的情況下，輸出的結果中會通過 code 和 message 指明出錯原因。
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}狀態碼說明
DashScope通用狀態碼請查閱：返回狀態碼說明
http 返回碼* | 錯誤碼（code） | 錯誤信息（message） | 含義說明 |
400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | 接口調用參數不合法 |