证件照-证件照背景色值-证件照背景色值检测API接口介绍

前言

现在线上报名、政务办事都得上传标准证件照，背景颜色能不能过关，往往是照片审核的第一道坎。但白底、蓝底、红底，每种都有固定的色值规范，拍摄时的光线、后期的修图，稍微一不注意，照片就容易出现背景偏色、边缘杂色这类问题。靠人工肉眼去一张张审核，效率低不说，判定标准也很难统一。针对大批量证件照背景色校验这个需求，本文设计并实现了一套证件照背景色值检测方案。核心思路是通过采样背景像素，结合色彩空间转换来排除光照干扰，然后把像素色值与官方标准区间做比对，自动判断背景是否合规，最后输出检测结果。这套工具可以直接嵌入到各类线上业务系统中，能大幅减轻人工审核压力，降低照片驳回率，提升政务、人事等场景的材料审核效率。

应用场景

线上政务平台：办理身份证、居住证、社保、出入境等业务时，在上传证件照环节就做前置校验，自动筛查红、白、蓝背景色值是否合规，从源头减少材料退回。各类考试报名系统：公考、教资、学历考试、职业资格证报名，都需要批量校验考生证件照背景，统一审核标准，减轻人工审核压力。企业人事管理：员工入职、社保公积金办理时批量检测证件照，规范人事档案照片格式，避免因为背景偏色导致存档不合格。校园教务系统：学籍注册、四六级考试、校园证件办理，对学生上传的照片做背景色值检测，实现照片标准化归档。证件照自助拍摄设备：照相馆、自助拍照机内置检测功能，拍摄后即时校验背景色彩，从源头输出合规的证件照。

API介绍

请求参数

名称	类型	必须	说明
appId	String	是	服务商分配的唯一标识。
timestamp	Long	是	当前时间毫秒数。
sign	String	是	签名，详见签名算法说明。
file	File	否	待检测图片文件，支持常见图片格式，例如 jpg、jpeg、png、webp。file、base64、url 三者至少传一个。
base64	String	否	图片 Base64 字符串，可带 data:image/...;base64, 前缀，服务端会自动移除前缀。file、base64、url 三者至少传一个；同时传 base64 和 file 时优先使用 base64。
url	String	否	图片公网可访问地址。file、base64、url 三者至少传一个；传了 base64 时优先使用 base64。
type	Integer	否	检测类型：1 只检测边框，2 只检测背景色，3 同时检测边框和背景色；不传默认 3。示例：0,80,145-220,240,255|0,0,180-60,80,255
colorRanges	String	条件必填	背景 RGB 色值或 RGB 区间。type=2 或 type=3 时必填；type=1 时不需要传。
colorTolerance	Double	否	命中 colorRanges 时允许的单通道偏差；不传默认 0。
targetChannel	String	条件必填	目标色值通道，用于判断背景色指定通道是否占优。type=2 或 type=3 时必填；常用值：r、g、b。
minChannelDiff	Double	否	目标通道占优阈值，例如蓝底照可传 targetChannel=b、minChannelDiff=15；不传默认 15。

戳这里查看详细说明

返回样例

{ "code": 200,"msg": "成功","taskNo": "41020892700032664119","charge": true,"data": {   "passed": true, // 按 type 计算后的最终检测结论  "border": false, // 是否检测到白色/灰色边框；仅 type=1 或 type=3 返回，true 表示有边框  "bgColorPassed": true, // 背景色是否命中 colorRanges；仅 type=2 或 type=3 返回  "bgRepColor": "80,189,229", // 检测到的背景代表色，格式通常为 R,G,B  "colorRange": "0,80,145-220,240,255" // 命中的色值范围；仅 type=2 或 type=3 且命中色值时返回}
}