检测给定图片中的所有人脸( Face )的位置和相应的面部属性,位置包括(x, y, w, h),面部属性包括性别( gender ), 年龄( age ), 表情( expression ), 魅力( beauty ), 眼镜( glass )和姿态 (pitch,roll,yaw )。
返回信息
字段类型说明
data.session_idString相应请求的 session 标识符,可用于结果查询
data.image_widthInt请求图片的宽度
data.image_heightInt请求图片的高度
data.faceArray(faceItem)检测出的人脸信息列表
codeInt返回状态码
messageString返回错误消息
FaceItem 说明
字段类型说明
face_idString人脸标识
xInt人脸框左上角 x
yInt人脸框左上角 y
widthFloat人脸框宽度
heightFloat人脸框高度
genderInt性别 [0(female)~100(male)]
ageInt年龄 [0~100]
expressionInt微笑[0(normal)~50(smile)~100(laugh)]
glassBool是否有眼镜 [true,false]
pitchInt上下偏移[-30,30]
yawInt左右偏移[-30,30]
rollInt平面旋转[-180,180]
BeautyInt魅力[0~100]
返回数据包示例:
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 313
Content-Type: application/json

{
    "data":{
    "session_id": "",
    "image_height": 200,
    "image_width": 200,
    "face": [{
        "face_id": "1005338790489817087",
        "x": 44,
        "y": 33,
        "height": 64.0,
        "width": 64.0,
        "pitch": 5,
        "roll": 0,
        "yaw": 6,
        "age": 37,
        "gender": 99,
        "glass": true,
        "expression": 6
        "beauty": 80
    }]
    },
    "code":0,
    "message":"OK"
}

展开/关闭说明


                    

对请求图片进行五官定位,计算构成人脸轮廓的 88 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子( 13 点)、嘴巴( 22 点)、脸型轮廓( 21 点)。各部分的点的顺序如图所示:

展开/关闭图片

返回信息
字段类型说明
data.session_idstring相应请求的 session 标识符,可用于结果查询
data.image_widthint请求图片的宽度
data.image_heightint请求图片的高度
data.face_shape.face_profilearray(Point)描述脸型轮廓的 21 点
data.face_shape.left_eyearray(Point)描述左测眼睛轮廓的 8 点
data.face_shape.right_eyearray(Point)描述右测眼睛轮廓的 8 点
data.face_shape.left_eyebrowarray(Point)描述左测眉毛轮廓的 8 点
data.face_shape.right_eyebrowarray(Point)描述右测眉毛轮廓的 8 点
data.face_shape.moutharray(Point)描述嘴巴轮廓的 22 点
data.face_shape.nosearray(Point)描述鼻子轮廓的 13 点
codeint返回状态码
messagestring返回错误消息
Point 说明
字段类型说明
xint坐标 x ,图片左上角为 0
yint坐标 y ,图片左上角为 0
返回数据包示例:
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 313
Content-Type: application/json

{
  "data":{
    "session_id": "",
    "image_height": 200,
    "image_width": 200,
    "face_shape": [{
      "face_profile": [{"x":48,"y":55},{"x":49,"y":61},{"x":49,"y":66},{"x":50,"y":71},{"x":51,"y":76},{"x":54,"y":81},{"x":56,"y":86},{"x":60,"y":90},{"x":65,"y":93},{"x":71,"y":95},{"x":77,"y":96},{"x":82,"y":95},{"x":87,"y":93},{"x":92,"y":90},{"x":94,"y":85},{"x":97,"y":81},{"x":99,"y":76},{"x":100,"y":71},{"x":101,"y":65},{"x":101,"y":60},{"x":101,"y":55}],
      "left_eye":[{"x":62,"y":55},{"x":64,"y":56},{"x":66,"y":57},{"x":68,"y":57},{"x":70,"y":56},{"x":69,"y":54},{"x":66,"y":54},{"x":64,"y":54}],
      "right_eye":[{"x":92,"y":55},{"x":90,"y":56},{"x":88,"y":56},{"x":86,"y":56},{"x":84,"y":56},{"x":85,"y":54},{"x":88,"y":53},{"x":90,"y":54}],
      "left_eyebrow":[{"x":56,"y":50},{"x":61,"y":50},{"x":65,"y":50},{"x":68,"y":50},{"x":73,"y":50},{"x":69,"y":47},{"x":64,"y":46},{"x":60,"y":47}],
      "right_eyebrow":[{"x":97,"y":50},{"x":93,"y":50},{"x":89,"y":50},{"x":86,"y":50},{"x":82,"y":50},{"x":85,"y":47},{"x":90,"y":46},{"x":95,"y":46}],
      "mouth":[{"x":67,"y":80},{"x":70,"y":83},{"x":74,"y":85},{"x":78,"y":85},{"x":81,"y":84},{"x":83,"y":82},{"x":86,"y":80},{"x":84,"y":78},{"x":81,"y":77},{"x":78,"y":78},{"x":74,"y":78},{"x":71,"y":79},{"x":71,"y":81},{"x":74,"y":81},{"x":78,"y":81},{"x":80,"y":80},{"x":83,"y":80},{"x":83,"y":79},{"x":80,"y":79},{"x":78,"y":80},{"x":74,"y":80},{"x":71,"y":80}],
      "nose":[{"x":79,"y":68},{"x":77,"y":56},{"x":75,"y":60},{"x":74,"y":64},{"x":72,"y":67},{"x":70,"y":70},{"x":74,"y":72},{"x":78,"y":72},{"x":81,"y":72},{"x":85,"y":70},{"x":83,"y":66},{"x":81,"y":63},{"x":81,"y":59}]
}]
  },
  "code":0,
  "message":"OK"
}

展开/关闭说明


                    

本接口用于计算两个 Face 的相似性以及五官相似度。

返回信息
字段 类型 说明
data.session_id String 相应请求的 session 标识符
data.similarity Float 两个 face 的相似度
data.fail_flag Int 标志失败图片,1 为第一张,2 为第二张(失败时返回)
code Int 返回码
message String 返回错误消息
返回数据包示例:
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 109
Content-Type: application/json

{
  "data":{
    "similarity":100.0,
    "session_id":""
  },
  "code":0,
  "message":"OK"
}

展开/关闭说明

人脸错误码说明
错误码含义
3错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4签名为空
5签名串错误
6签名中的 appid/bucket 与操作目标不匹配
9签名过期
10appid 不存在
11secretid 不存在
12appid 和 secretid 不匹配
13重放攻击
14签名校验失败
15操作太频繁,触发频控
16Bucket 不存在
21无效参数
23请求包体过大
107鉴权服务内部错误
108鉴权服务不可用
213内部错误
-1101人脸检测失败
-1102图片解码失败
-1103特征处理失败
-1104提取轮廓错误
-1105提取性别错误
-1106提取表情错误
-1107提取年龄错误
-1108提取姿态错误
-1109提取眼镜错误
-1200特征存储错误
-1300图片为空
-1301参数为空
-1302个体已存在
-1303个体不存在
-1304参数过长
-1305人脸不存在
-1306组不存在
-1307组列表不存在
-1308url 图片下载失败
-1309人脸个数超过限制
-1310个体个数超过限制
-1311组个数超过限制
-1312对个体添加了几乎相同的人脸
-1400非法的图片格式
-1403图片下载失败
图片鉴黄错误码说明
错误码含义
3错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4签名为空
5签名串错误
6appid/bucket/url不匹配
7签名编码失败(内部错误)
8签名解码失败(内部错误)
9签名过期
10appid 不存在
11secretid 不存在
12appid 不匹配
13重放攻击
14签名失败
15操作太频繁,触发频控
16内部错误
17未知错误
200内部打包失败
201内部解包失败
202内部链接失败
203内部处理超时
-1300图片为空
-1308url 图片下载失败
-1400非法的图片格式
-1403图片下载失败
-1404图片无法识别
-1505url 格式不对
-1506图片下载超时
-1507无法访问 url 对应的图片服务器
-5062url 对应的图片已被标注为不良图片,无法访问(专指存储于腾讯云的图片)
OCR识别错误码说明
错误码含义
3错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4签名为空
5签名串错误
6appid/bucket/url不匹配
7签名编码失败(内部错误)
8签名解码失败(内部错误)
9签名过期
10appid 不存在
11secretid 不存在
12appid 不匹配
13重放攻击
14签名失败
15操作太频繁,触发频控
16Bucket 不存在
17url 为空
18没有图片或 url
19图片数过多,单次请求最多支持20个 url 或文件
20图片过大,单个文件最大支持 1MB
21无效的参数
200内部打包失败
201内部解包失败
202内部链接失败
203内部处理超时
-1102图片解码失败
-1300图片为空
-1301请求的参数为空
-1308url 图片下载失败
-1400非法的图片格式
-1403图片下载失败
-1404图片无法识别
-1505url 格式不对
-1506图片下载超时
-1507无法访问 url 对应的图片服务器
-5062url 对应的图片已被标注为不良图片,无法访问(专指存储于腾讯云的图片)
-5103OCR 识别失败
-5107提供的图片不是身份证
人脸核身错误码说明
错误码含义
3错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4签名为空
5签名串错误
6签名中的 appid/bucket 与操作目标不匹配
9签名过期
10appid 不存在
11secretid 不存在
12appid 和 secretid 不匹配
13重放攻击
14签名校验失败
15操作太频繁,触发频控
16Bucket 不存在
21无效参数
23请求包体过大
24无权限,未申请服务
107鉴权服务不可用
108鉴权服务不可用
213内部错误
-4006视频中自拍照特征提取失败
-4007视频中自拍照之间对比失败
-4009Card 照片提取特征失败
-4010自拍照与Card照片相似度计算失败
-4011照片解码失败
-4012照片人脸检测失败
-4015自拍照人脸检测失败
-4016自拍照解码失败
-4017Card 照片人脸检测失败
-4018Card 照片解码失败
-5001视频无效,上传文件不符合视频要求
-5002唇语失败
-5005自拍照解析照片不足,视频里检测到的人脸较少
-5007视频没有声音
-5008语音识别失败,视频里的人读错数字
-5009视频人脸检测失败,没有嘴或者脸
-5010唇动检测失败,视频里的人嘴巴未张开或者张开幅度小
-5011活体检测失败(活体其他错误都归类到里面)
-5012视频中噪声太大
-5013视频里的声音太小
-5014活体检测 level 参数无效
-5015视频像素太低,最小 270*480
-5016视频里的人不是活体(翻拍等攻击)
-5801请求缺少身份证号码或身份证姓名
-5802服务器内部错误,服务暂时不可用
-5803身份证姓名与身份证号码不一致
-5804身份证号码无效
-5805用户未输入图像或者 url 下载失败
图片处理
错误码含义
-5999参数错误
-5998签名格式错误
-5997后端网络错误
-5996HTTP 请求方法错误
-5995文件大小错误
-5994url 参数解析不匹配
-5993multipart/formdata 参数错误
-5992请求参数错误
-5991分片过大
-5990找不到 filecontent
-5989上传失败
-5988cgi 初始化错误
-5987wup 编码失败
-5986wup 解码失败
-5985获取路由失败
-5984sha1 不匹配
-5983错误的 session
-5982建立连接错误
-5981建立连接错误
图片下载错误码说明(图片下载失败时,返回包 headers 中的 X-ErrNo 字段错误码说明。)
错误码含义
-6101图片不存在、图片没有上传或者图片已经删除
-5062图片涉嫌违禁
-902镜像存储功能把请求转发到开发商源站,但没有收到响应,超时了
-100未知错误,某些场景或者逻辑未定义
-101存储文件失败
-103无效的请求;请求报文无法识别
-104无效的 appid 。Url 中包含的 appid 无效,或者域名没有和 appid 绑定
-105无效的样式名。 Url 中指定的样式名或者别名没有配置
-106无效的 URL 。 Url 格式不符合格式要求
-107无效的 Host 头域
-108无效的 Referer
-109无效的样式名 ID 。没有找到该样式名对应的图片。可能是上传该图片后,新增的样式名, 因此图片上传时不能生成该样式名对应的数据
-110该图片在黑名单中
-111http 服务器内部错误
-120回源到源站获取数据时,源站返回的数据有异常,无法正常获取到图片数据
-121http 服务器内部错误
-122图片数据没有修改,客户端可以使用缓存数据
-123图片数据没有修改,客户端可以使用缓存数据
-124下载偏移错误。 Http 请求的 Range 断点续传偏移量可能设置错误
-129无法预料的错误
-130http 服务器内部错误
-140http 服务器内部错误
图片插件错误码说明
错误码含义
-2000服务过载
-1900框架 handle process 错误
-1899存储文件失败
-1898校验 md5 失败
-1897秒传失败
-1896编码失败
-1895解码失败
-1894业务 ID 错误
-1893图片数据异常,压缩库无法处理
-1892上传失败,服务器错误
-1891解码 biz_req 失败
-1890编码 biz_req 失败
-1889存储文件超时
-1888压缩超时
-1887校验 sha1 失败
-1886图片 fileid 已经存在
文件缓存错误码说明
错误码含义
-300服务过载
-299命令字未知
-298解包失败
-297框架 handle process 错误
-296打包失败
-295文件数据异常
-294文件数据异常
-293通知插件失败
-292文件缓存服务器错误
-291编码 session 失败
-290无效的 session
-289插件拒绝上传
-288process 打包失败
-287process 解包失败
-286解码 session 失败
-285文件过大
-284分片大小不一致
-283分片过小
cmd错误码说明
错误码含义
-199文件移动失败
-198重定向错误
-197查无此文件
-196网络请求失败
-195网络请求失败
-194后端打包失败
-193返回包打包失败
-192请求包解析失败
-191url 参数解析不匹配
-190文件删除失败
-189输入参数错误:download_url empty
-187从 url 中解析参数失败
-186暂不支持视频文件复制
-185业务预处理失败
-184业务后处理失败
-183获取路由失败
-182参数检验失败
proxy错误码说明
错误码含义
-99proxy 读取配置失败
-98调用签名服务失败
-97非法签名
-96签名过期
-95消息缺少 session 信息
-94携带错误 session 信息
-89proxy 转发 cmd 服务失败
-88编码 cmd 服务消息失败
-87解析 cmd 服务消息失败
-86proxy 转发 process 服务失败
-85解析 process 服务应答失败
-84获取 process L5 失败
-83签名服务解包失败
-82不存在此 appid
-81签名为空
-80非法的业务 ID
-79secret id 不存在
-78SDK 协议不匹配,请升级
-77单次性签名已不可用
-76单次签名没有 url
-75不支持此操作
-74多次签名-过期时间为 0
-73单次签名-过期时间不为 0
-72签名失败
-71操作太频繁,请稍后再试
-70appid/userid 与签名不匹配
-69输入参数错误: download_url empty
-68ip 直通车打包失败
-67ip 直通车解包失败
-65断点续传不支持携带数据包
-64该业务已经被屏蔽

© 2018 zxy97.com 版权所有 | 陕ICP备18005813号