温馨提示:

  1. app_key为接口调用有效凭证,为确保安全,请将接口请求放置于自己的服务器上进行,并注意不要泄露
  2. 当接口调用剩余次数在30000,20000,5000,2000,1000,500,100次的时候,邮箱和注册的手机号会收到充值提醒。
  3. 若返回的结果里存在result,则表内后续数据为result对象内的数据,即:result:{column1:...,...}
  4. 除环境检测接口外,其他接口的 file 都可传图片的云端路径,即通过第十三个接口获取key,上传图片后将key作为第2、3、4、8、10、11、14、15、16个接口的file参数传入。
  5. 为方便查阅,以下列出常见响应状态码,非 2XX 状态码的提示字段为“error”:
状态码 描述 解决方案
200 请求成功
11000 NO FACE 重新上传图片
11001 MORE THAN ONE FACE 重新上传图片
11002 NOT ENOUGH FACE 重新上传图片
400 规格不存在(或者请求错误) 输入已有规格(检查json格式
401 app_key不存在 输入已申请的正确app_key
403 身份验证不通过 检查secret_key是否正确
412 app_key类型不正确 输入已申请的对应类型的app_key
417 已达到最大调用次数 购买调用次数
421 The parameter is not JSON 检查请求参数的类型是否为json
422 缺少对应的参数 检查上传的参数中缺少的对应项
423 数据类型错误 按提示信息检查修改
424 the background_color length is more than six. 背景色设置不能超过6种
430 liveness_threshold数据传输错误 liveness_threshold类型需为数字,且不能小于0
432 ratios's length less then 2 or ratios's type is not a array. 检查ratios类型
433 hat_params's type is not a dict. 检查hat_params类型
501 图片制作失败,请换张照片试试 重新上传一张图片
503 没检测到人脸 重新上传一张图片
506 上传的base64数据不是图片 检查base64编码后的数据,不包括头部数据,或者使用第十三个接口上传图片
507 该图片缺少部分身体不能制作此规格 提示用户重新拍摄或者重新上传图片制作

目前针对2,4,11接口返回的algo_code说明如下:

状态码 说明
200 处理成功
400 文件不存在
406 未检测到人脸或检测到多张人脸
407 未检测到人脸或检测到多张人脸
408 该图片不能制作该规格
409 服装通道不正确
410 结婚照美颜失败
411 人物领口被遮挡, 无法换装
412 衣服模板特征点查找失败
413 人像脖子点查找失败
414 换装异常
415 检测到多张人脸(相对于420状态码,此状态码一般在单人检测时返回)
416 人脸露出不完整
417 没有匹配的人脸特征
418 人脸数量过少
419 缺少参数
420 过多的人脸(一般在双人照时,遇到人脸超过2张时返回)
421 检测到非活体
422 输入图片过小
423 输入图片过大
424 没有识别到证件区域
425 图片过于模糊
426 图片审核工具审核失败
427 人脸旋转角度过大
500 未知异常