证件照抠图换装

描述

证件照抠图 + 证件照换装二合一接口

接口鉴权

接口地址

【POST】https://open-api.gaoding.com/api/call/passportclothswap

请求头（request header）

字段	类型	是否必填	字段描述
app_id	string	是	应用ID，获取方式：应用列表 -> 应用详情 -> APP ID

请求体（request body）

字段	类型	是否必填	字段描述
url	string	二个必填一个优先级：url>file_base64	原图url，支持JPG、PNG格式仅保留1个月，请及时转储（无文件大小限制）
file_base64	string	二个必填一个优先级：url>file_base64	原图的base64码（最大支持3M文件）
result_type	string	否	结果返回类型：枚举值：url，base64 默认url
background	string	是	背景颜色 RGB , 当为 transparent 时背景透明
width	number	是	裁剪图片宽
height	number	是	裁剪图片高
file_type	string	否	获得图片类型 jpg , png，默认jpg
quality	number	否	最大值: 1 最小值: 0
dpi	number	否	导出图片DPI，默认300
gradient	number	否	1：背景色渐变，0：背景色不渐变，默认0
background_stop	string	gradient=1时必填	背景渐变结束颜色 RGB
portrait_check	number	否	是否进行人像检查，1:是，0:否，默认0。准确度不够高，建议制作证件照前先使用人像属性检测接口进行检测
cloth_classify	string	是	衣服分类四类：['boy','girl','man','woman']
cloth_id	number	是	服装ID（代表第几套衣服，请先输入衣服分类，再输入分类下对应的服装ID，衣服见：衣服样式映射）

请求体示例（url）：

{
  "url":"https://matting-batch.dancf.com/cloths/20220825_143743_gaoding_imagematting_human.jpg",
  "width":295,
  "height":413,
  "background":"#ffffff",
  "cloth_classify": "woman",
  "cloth_id": 4
}

请求体示例（base64）：

{
  "file_base64":"图片的base64编码",
  "width":1500,
  "height":1500,
  "background":"#ffcc66",
  "cloth_classify": "boy",
  "cloth_id": 1
}

尺寸参考（仅供参考，width和height可自定义）：

证件类型尺寸	尺寸（毫米）	尺寸（像素）
一寸	25x35	295x413
小一寸	22×32	260×378
大一寸	33×48	390×567
二寸	35x49	413×579
小二寸	35×45	413×531
大二寸	35x53	413x626

类型	尺寸（毫米）	尺寸（像素）
学籍照片	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）

响应体（response body）

字段	类型	是否必存在	字段描述
result	string	是	结果图url，返回PNG格式，仅保留1个月，请及时转储。
width	number	是	图片宽
height	number	是	图片高

响应示例1（模拟正常请求）：

http_status：200

response body：

{
  "code": 0,
  "result": "https://matting-batch.dancf.com/product/api/12163bd3035cafcab0cce4a519bcc0f5-20220827120827649.png"
}

响应示例2（模拟参数非法请求）：

http_status：400

response body：

{
    "code": -10003,
    "message": "InvalidArgsError"
}

错误码

HTTP状态码	业务错误码	含义
400	-10003	参数非法
400	-10024	通过指定的upload_address 上传的的时候失败
400	-10001	下载失败，可能是用户传的url非法，或者网络异常等原因导致下载失败
400	-10002	解码图片失败，可能是某些格式比较特殊的图片暂时还不支持，或者图片url下载下来根本不是图像数据
400	-10007	图片数据过大，无法处理
422	-11001	未识别到人脸
422	-11002	人脸不完整
422	-11003	检测到多个人脸
422	-11004	佩戴眼镜， portrait_check=1时有效
422	-11005	佩戴帽子， portrait_check=1时有效
422	-11006	佩戴首饰， portrait_check=1时有效
422	-11007	人脸左右倾斜， portrait_check=1时有效
422	-11008	左右侧脸， portrait_check=1时有效
422	-11009	上下抬脸， portrait_check=1时有效
422	-11010	肩膀不齐平， portrait_check=1时有效
422	-11011	照片模糊， portrait_check=1时有效
422	-11012	阴阳脸， portrait_check=1时有效
422	-11013	黑白照， portrait_check=1时有效
500		服务器错误
422		接口入参错误