证件照抠图
接口描述
本接口用于将相片中的人像抠出,使用设置的背景色及尺寸返回证件照。
请求说明
HTTP 方法:
POST
请求 URL:
/ai-cloud-cweis/credentials/matting
Header如下:
参数名称 | 值 |
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
参数名称 | 是否必选 | 数据类型 | 参数描述 |
appKey | 是 | String | 应用生成的appkey |
sign | 是 | String | 签名 |
nonceStr | 是 | String | 随机字符串 |
busFlowId | 否 | String | 业务流水号(排查问题用,建议传入) |
imgUrl | 否 | String | 原图 url,支持JPG、PNG 格式 |
img | 否 | String | 原图的Base64值,支持JPG、PNG 格式 |
background | 是 | String | 背景颜色 RGB,如 #ffffff,当为transparent时背景透明 |
width | 是 | number | 裁剪图片宽 |
height | 是 | number | 裁剪图片高 |
file_type | 否 | String | 获得图片类型 jpg , png |
quality | 否 | number | 最大值: 1 最小值: 0 默认为0.9 |
portraitCheck | 否 | number | 是否进行人像检查,1:是,0:否;默认为1 |
注:
- img和imgUrl两个必填一个,若都填,则优先imgUrl;
jpg格式图片不支持背景色为透明的情况,png格式图片不支持图片质量的选择;
图片限制像素范围3000*3000之内;
width,height限制3000之内。
background颜色范围#000000~#fffffff。
返回说明
返回参数:
返回值名称 | 类型 | 描述 |
code | int | 返回结果,0表示成功 |
message | String | 返回码描述 |
data | Object | 返回的数据 |
result | String | 结果图 url |
width | number | 图片宽 |
height | number | 图片高 |
dpi | number | 图片DPI |
返回示例:
{
"code": 0,
"message": "调用成功",
"data": {
"width": 295,
"height": 413,
"dpi":300,
"result": "https://gd-file-manage-test.dancf.com/gaoding/matting/passport/a4c5f6d95bb0afa0f0d54a05912dc6851626258775009.jpg"
}
}
错误码
错误码 | 含义 |
---|---|
4301 | 通过指定的 upload_address 上传的的时候失败 |
4302 | 下载失败,可能是用户传的 url 非法,或者网络异常等原因导致下载失败 |
4303 | 解码图片失败,可能是某些格式比较特殊的图片暂时还不支持,或者图片 url 下载下来根本不是图像数据 |
4304 | 图片数据过大,无法处理 |
4305 | 未发现人脸 |
4203 | 服务器错误 |
4110 | 参数错误 |
尺寸参考
类型 | 尺寸(毫米) | 尺寸(像素) |
---|---|---|
学籍照片 | 26×32 | 307×378 |
学信网 | 41×54 | 480×640 |
全国计算机等级考试 | 12×16 | 144×192 |
护士执业资格考试 | 14×18 | 160×210 |
教师资格证 | 30×41 | 360×480 |
泰国签证 | 40×60 | 472×708 |
日本签证 | 45×45 | 531×531 |
美国签证 | 51×51 | 600×600 |
越南签证 | 40×60 | 472×708 |
居民身份证制证用数字相片技术标准(GA461-2004) | 26 x 32 | 358x441(DPI 350) |
证件类型尺寸 | 尺寸(毫米) | 尺寸(像素) |
---|---|---|
一寸 | 25x35 | 295x413 |
小一寸 | 22×32 | 260×378 |
大一寸 | 33×48 | 390×567 |
二寸 | 35x49 | 413×579 |
小二寸 | 35×45 | 413×531 |
大二寸 | 35x53 | 413x626 |