证件照-证件照背景色值检测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 且命中色值时返回
  }
}