证件照检测API接口的应用

原创

聚美智数

发布于 2026-02-25 16:19:48

1000

在数字化服务无处不在的今天，证件照作为身份认证、考试报名、政务办理等场景的“敲门砖”，其质量与合规性直接关系到业务流程的顺畅度。然而，对于广大开发者而言，自研一套能够精准检测人脸、智能抠图、自动替换背景并符合各国/各行业标准的证件照处理系统，不仅技术门槛高（涉及深度学习、图像分割、色彩校正等），而且开发周期长、维护成本巨大。

随着AI技术的成熟，证件照检测接口API已成为企业快速集成该能力的最佳选择。

功能特性

支持多个检测项，包括：性别、年龄、头顶完整性、面部完整性、面部画质、拍摄距离、五官遮挡、胡子、头部是否摆正、露双耳、睁闭眼、嘴巴闭合、眼镜、妆容、配饰等。
检测后返回所有检测项的检测结果，开发者可用于判断照片是否达到应用场景标准。

接口说明

请求参数

名称	类型	必须	说明
imageType	String	是	图片类型，支持jpg、jpeg、png、bmp
base64	String	否	照片base64串
file	File	否	照片文件
url	String	否	照片url

base64、file、url 必须提供一个，优先级：base64 > file > url

详见此处

返回样例

{
  "code": 200,//返回码，详见code返回码说明
  "msg": "成功",//code对应的描述
  "charge": true,//计费标志
  "taskNo": "256913605225230722458167",//本次唯一请求号
  "data": {
     // 返回字段说明: https://file.jumdata.com/support/idphote-check/id-phote-checkv2-code.xlsx
    "failed_item_list": {//不符合预期
      "FaceEar": [
        {
          "msg": "左耳未露出",
          "code": "500031" //业务code
        }
      ],
      "FaceMustache": [
        {
          "msg": "脸部存在胡须",
          "code": "500012"
        }
      ]
    },
    "success_item_list": {//符合预期
      "BodyInfo": [
        {
          "msg": "身体检测符合预期",
          "code": "600070"
        }
      ],
      "FaceOutDetect": [
        {
          "msg": "人像面部完整",
          "code": "600007"
        }
      ]
    }
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-gateway