证件照抠图


接口描述

本接口用于将相片中的人像抠出,使用设置的背景色及尺寸返回证件照。

请求说明

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

注:

  1. img和imgUrl两个必填一个,若都填,则优先imgUrl;
  2. jpg格式图片不支持背景色为透明的情况,png格式图片不支持图片质量的选择;

  3. 图片限制像素范围3000*3000之内;

  4. width,height限制3000之内。

  5. 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
是否仍需要帮助? 请保持联络!
最后更新于 23rd Apr 2024