人物检测 API 接口文档

创建任务

POST/v2/process/result/personDetect/create

请求数据类型:application/json
响应数据类型:application/json

判断图片「是否包含真人人体」。图片将按长边缩放到不超过 1024 后，由 AI 判断画面主体是否像真实活人（或其身体部位，如人脸、手、脚等）。逼真的人像（包括 AI 生成的逼真人物）判定为包含；雕塑、假人模特、卡通、动漫、钱币上的人物等判定为不包含。

请求体

imageUrlstring必填

图片地址，须以 http:// 或 https:// 开头

请求示例

JSON

{
    "imageUrl": "https://example.com/image1.jpg"
}

响应体

traceIdstring

链路ID

codestring

状态码 200 为成功其他为失败

msgstring

成功/错误描述

msgKeystring

错误描述编码，状态码不等于200时存在

dataobject

对象字段

idinteger

任务id

typeinteger

任务类型，固定为 6

响应示例

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": "200",
  "msg": "成功",
  "data": {
    "id": 123456,
    "type": 6
  }
}

查询任务结果

POST/v2/process/result/personDetect/infoapplication/json

请求体

idinteger必填

任务id

请求示例

JSON

{
  "id": 123456
}

响应体

traceIdstring

链路ID

codestring

状态码 200 为成功其他为失败

msgstring

成功/错误描述

msgKeystring

错误描述编码，状态码不等于200时存在

dataobject

对象字段

statusinteger

状态
1.已创建 2.执行中 3.成功 4.失败

resultobject

结果（status=3 时存在）

对象字段

resultstring

判断结果：yes 或 no

reasonstring

中文判断理由

errorstring

失败时的错误描述（status=4 时存在）

countinteger

实际扣点，成功 20，失败 0（已退还）

响应示例

成功

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": "200",
  "msg": "成功",
  "data": {
    "status": 3,
    "result": {
      "result": "yes",
      "reason": "画面主体为真实人物全身照"
    },
    "count": 20
  }
}

执行中

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": "200",
  "msg": "成功",
  "data": {
    "status": 2,
    "count": 20
  }
}

失败

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": "200",
  "msg": "成功",
  "data": {
    "status": 4,
    "error": "人物检测识别失败",
    "count": 0
  }
}

result 字段说明

result 值	含义
yes	图片包含真人人体（含逼真 AI 人像）
no	图片不包含真人人体（雕塑、假人、卡通、钱币等）

扣费标准

每次创建任务预扣 20 算力点，任务失败自动全额退还；账户剩余点数不足 20 点时拒绝创建。创建限流：每个团队每 10 秒最多 3 次。查询任务结果不额外扣点。