AnimateAnyone图像检测API_大模型服务平台百炼(Model Studio)-阿里云帮助中心

AnimateAnyone图像检测模型，用于确认输入的人物图像是否符合AnimateAnyone视频生成模型的要求。本文档介绍了该模型提供的图像检测能力的API调用方法。

模型概览

模型名	模型简介
animate-anyone-detect-gen2	animate-anyone-detect-gen2是一个图像检测模型，专门用于检测输入的图片是否满足animate-anyone-gen2模型所需的人物图像规范。

效果示例

人物图像检测通过示例

人物全身照

人物半身照

单人从头到脚完整露出、身体无遮挡
面朝镜头，无大角度侧身或镜头俯仰

AA_正面建议_全身@4x

单人腰部以上完整露出、身体无遮挡
面朝镜头，无大角度侧身或镜头俯仰

AA_正面建议_半身@4x

人物图像检测不通过示例

非正面照

（侧身侧脸）

光线暗淡

（人物不清晰）

人物遮挡

（服饰遮手、手持物品等）

复杂背景

多人照片

AA_错误_侧身侧脸@4x

AA_错误_光线暗淡@4x

AA_错误_手拿物品@4x

AA_错误_复杂背景@4x

HTTP调用接口

功能描述

该模型用于检测输入的图片是否满足“AnimateAnyone 视频生成API”所需的人物图片规范。

前提条件

已开通服务并获得API-KEY：获取API Key。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-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	"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.	单人的人脸不符合要求（要求面部可见，头部朝向无严重偏移）