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

AnimateAnyone-detect模型，用于确认输入的人物图像是否符合AnimateAnyone模型的规范。本文档介绍了该模型提供的图像检测能力的API调用方法。

模型概览

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

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-xxx
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

请求示例

以下示例展示通过CURL命令来调用本模型的脚本

说明

需要使用您的API-KEY替换示例中的 your-dashscope-api-key ，代码才能正常运行。

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect' \
--header 'Authorization: Bearer <YOUR_API_KEY> \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "<YOUR_MODEL>",
  "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"
}

检测不通过的原因说明：

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.	单人的人脸不符合要求（要求面部可见，头部朝向无严重偏移）

状态码说明

大模型服务平台通用状态码请查阅：状态码说明