证件照制作-证件照生成-证件照优化API接口介绍

使用证件照制作API的核心原因在于解决传统证件照拍摄和制作过程中的效率低、成本高、标准难统一、用户体验差等痛点。对于企业、开发者或平台运营者来说，接入API不仅仅是“做一个功能”，更是为了降本增效和提升业务转化率。

功能特性

• 支持：替换背景、自动裁剪尺寸、设置分辨率、设置人脸在证件照中的占比、设置脸部中心在证件照中的位置、设置头顶距离
• 随时随地办理：用户无需专门跑照相馆，只需在手机/电脑端上传自拍或生活照，几秒钟即可生成合规照片。这对于急需报名考试、办理签证或入职的用户极具吸引力。
• 即时反馈：用户可立即预览效果并调整（如更换背景色、微调美颜），满意度更高。
• 快速集成：成熟的API通常提供完善的SDK和文档，开发人员可在几小时甚至几十分钟内完成集成上线，极大缩短产品上市时间（Time-to-Market）。
• 降低流失率：在注册、报名或认证流程中，如果要求用户上传严格符合标准的照片，很多用户会因“不知道怎么拍”或“反复上传失败”而放弃。API提供的实时检测与自动修正功能（如自动换底、裁剪），能显著降低操作门槛，提高流程完成率。

接口说明

请求参数

名称	类型	必须	说明
base64	String	否	照片base64串
file	File	否	照片文件
url	String	否	照片url
spec	String	否	证件照规格ID，见spec及bgColor参考
bgColor	String	否	证件照颜色值: blue, red, white等值，或者以井号开始的16进制颜色值：#FF0000，见spec及bgColor参考
beautyDegree	Float	否	美颜级别，浮点型，如1.5，取值范围[1.0-5.0]，超出范围后的值无效。主要调节了脸部黑白平衡。
size	String	否	证件照像素尺寸，格式:"宽x高"（中间分隔符为小写字母x），比如"480x640"。为了避免和spec内定的像素大小冲突，使用本参数的同时，需要将spec设置为"12"。
fileSize	String	否	证件照图片的文件大小， 如果期望证件照图片的文件大小（kb）在一定的限制范围内，可以设置这个值，值的单位为kb，格式为："最小值,最大值"，比如"10,100"表示希望返回的证件照文件大小在10-100kb之间；说明：该参数的单位为kb，而不是字节，如果文件大小如果设置不合理，比如过大或者过小，返回的文件大小有可能不在设定范围内。
dpi	Integer	否	返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片，个别证件照规格会返回350dpi的图片
faceRatio	Float	否	证件照中人脸占比参数，浮点类型，取值范围（0-1.0）不设置，则服务端会给出默认配置，一般为0.5，个别证件照规格为0.4，如果觉得我们返回的人脸过大或者过小，可以自行调节该值
faceCenterRange	Float	否	脸部中心高度在证件照中的位置，浮点类型，取值范围（0-1.0），默认值为0.45；这个参数可以决定人脸在证件照所处于的高度
topEmpty	Float	否	用来约定生成证件照中，头顶距离照片顶部的距离范围，格式为“最小值,最大值”（使用英文字母逗号分隔），单位为像素，比如期望生成的证件照，人的头顶留空最少10个像素，最多30个像素，可以给出值 "10,30" 。注意不能两个值都设置为0，最大值必须大于最小值，最大值不能大于等于证件照的高度。当这个值不设置时，不做头顶留空的判断。人脸在证件照中的高度位置定位原则说明：先根据face_center_y（默认值为0.45）来定位人脸高度位置，然后对比top_empty（如有设置）参数，调整人脸位置，使其符合top_empty要求，最后还会判断人体底部是否可能悬空（原图人像高度不够时可能会发生这个问题），如果出现悬空的现象，则需要将人像向下移动至不悬空的位置

base64、file、url 必须提供一个，优先级：base64 > file > url

详见此处

返回样例

{
  "code": 200,// 返回码，详见返回码说明
  "msg": "成功", // 返回码对应描述
  "taskNo": "254900443205524179659164",// 本次请求号
  "charge": true,// 计费标志
  "data": {
    "result": "xxx.jpg",//证件照图片URL。有效期1天，请尽快下载保存
    "size": [ //证件照尺寸[宽, 高]
      "600",
      "800"
    ]
  }
}

spec及bgColor参考

title	id	spce	color
导游证	14	285x385	white,blue_gradual
小一寸	2	22mmx32mm	blue,white,red,blue_grey,blue_gradual,gray_gradual
大一寸	3	33mmx48mm	blue,white,red,blue_grey,blue_gradual,gray_gradual
职业兽医资格证	32	230x334	blue,red,white
成人自考	33	384x512	blue,white
英语四六级考试	46	240x320，20~30kb	blue,white
普通话水平测试	50	390x567	blue
大二寸	6	35mmx53mm	blue,white,red,blue_grey,blue_gradual,gray_gradual
执法证	26	265x351	white
校园卡	27	240x320	blue
一级建造师证（电子版）	30	472x630	blue,red,white
英语四六级考试	42	144x192，10~20kb	blue,white,blue_gradual
学籍照片	67	358x441	white
社保卡（350dpi， 无回执，50~100KB）	13	358x441	white
医保证	24	358x441	white
泰国签证	77	35mmx45mm	white
国考（二寸）	22	35mmx45mm	blue,blue_gradual,red,white
美国签证	7	51mmx51mm	white
五寸	21	89mmx127mm	blue,blue_gradual,red,white
二级建造师证	29	295x413	white
巴西、冰岛签证	86	40mmx50mm	white
二级建造师证	31	455x661	blue,white
电子护照人像照片	37	33mmx48mm	white
入台证	81	35mmx45mm	white
入学照	17	25mmx35mm	blue,blue_gradual,red,white
教师资格证	15	25mmx35mm	white
健康证（一寸）	25	25mmx35mm	blue,red,white
成人自考	35	25x35mm	blue,white,red
学位英语	48	390x567	white
高考报名	70	420x560	blue
社保卡（350dpi)	71	252x312	white
四寸	20	76mmx102mm	blue,white,red,blue_gradual
英语AB级考试	49	390x567	blue
入学报名（一寸）	68	25mmx35mm	white
大学入学（小二寸）	69	35mmx45mm	blue
一寸	1	25mmx35mm	blue,blue_gradual,red,white
驾驶证、驾照（无回执，小一寸）	16	22mmx32mm	white
二寸	4	35mmx49mm	blue,white,red,blue_gradual
阿根廷签证	85	40mmx40mm	white
肯尼亚签证	87	50mmx50mm	white
英语四六级考试	40	144x172，0~40kb	blue
社保卡（350dpi， 无回执，10-20KB）	72	358x441	white
社保卡（350dpi， 无回执，25~40KB）	73	358x441	white
马来西亚签证	82	35mmx45mm	white
越南签证	9	40x60mm	blue,red,white
入台证（小二寸）	28	35mmx45mm	white
执业医师资格报名	62	354x472	blue,white
日本签证	8	45mmx45mm	white
居住证	11	26mmx32mm	white
三寸	19	55mmx84mm	blue,white,red,blue_gradual
简历照片（一寸）	18	25mmx35mm	blue,red,white
国家司法考试	23	413x626	blue
会计从业资格证	39	25mmx35mm	white
港澳通行证	75	33mmx48mm	white
印度签证	78	51mmx51mm	white
新西兰签证	83	76mmx102mm	white
身份证（无回执）	10	26mmx32mm	white
世界通用签证	74	35mmx45mm	white
签证采集	80	30mmx40mm	white
韩国签证	76	35mmx45mm	white
公务员考试	36	35mmx45mm	blue,red,white
小二寸	5	35mmx45mm	blue,white,red,blue_gradual
执业药师资格考试（一寸）	60	295x413	blue,white,red
执业药师资格考试（二寸）	61	413x579	blue,white
以色列签证	79	51mmx51mm	white
意大利签证	84	35mmx40mm	white
一级建造师证（电子版）	93	472x630	blue,red,white
海外申请护照在线预约照片	38	33mmx48mm	white
护士执业资格考试(20~45kb)	94	160x210，20~45kb	white
公务员考试报名	95	340x450(20k以内)	blue,white
入金证	96	35mmx45mm	white
社保卡（350dpi， 无回执，大于100KB）	97	358x441	white
成人自考（本科）	98	480x720	blue,white
自考学位外语考试（390x567）	99	390x567	blue,white
英语四级考试	100	480x640，100KB	blue
二级建造师（天津）	101	160x200，20~40kb	blue,white
二级建造师（湖南）	102	130x170	blue,white
社保证（350dpi， 无回执，30~60kb）	103	358x441	white
英语AB级考试(144X192)	104	144x192	blue,white
英语三级考试	105	144x192	blue,white
公务员考试(130X170)	106	130x170	white
二级建造师（西藏）	107	455x661	blue
国家公务员考试	108	25x35mm	blue,white
保险职业认证	109	210x270（10-25K）	white
注册会计师考试（178x220）	110	15x19mm	white
保险职业证	111	210x370（10-25K）	white
全国计算机等级考试	53	33x48mm	blue,white
事业单位招聘	112	90x120	blue
英语三级	113	33mmx48mm	blue,white
半身职业照	114	850x1200	blue,blue_gradual,red,red_gradual,white,gray_gradual
成人自考	115	480x640	blue
高清证件照	116	1000x1400	blue,white,red,blue_gradual
成人高考报名	117	295x413	blue
全国计算机等级考试	119	12x16mm	blue,white,red
车载终端照片	120	96x128	red
河北社保卡（300dpi， 无回执，小于100KB）	121	358x441, 300dpi	white
教师资格证	122	150x200像素，不大于200K	white
卫生专业技术资格考试	123	35mmx45mm	blue,white
小二寸	125	35mmx45mm	blue,white,red,blue_gradual
贵州公务员考试	127	35x49mm	blue,white
海南公务员	128	14x18mm	blue,white,red
湖北公务员考试	129	25x35mm	blue,white
江西公务员考试	130	35x45mm	blue,white
山东公务员考试	132	35x45mm	blue,white
成都公务员	133	9x11mm	blue,white,red
深圳公务员	134	13x18mm	blue,red
国考（100x140）	135	8x12mm	blue
国考（99x128）	136	8x11mm	blue
甘肃省（国考）	137	18x25mm	blue,white,red
江西省（国考）	138	8x11mm	blue
宁夏回族自治区（国考）	139	18x25mm	blue
青海省（国考）	140	10x15mm	blue
山东省（国考）	141	10x13mm	blue
上海市（国考）	142	18x25mm	blue
浙江省（国考）	143	8x12mm	blue
教师资格证（180x240）	144	15x20mm	blue,white,red
中国教师资格证	145	10x13mm	blue,white,red
福建教师资格证	146	25x34mm	white
教师资格证（150x200）	147	13x17mm	white
教师资格证（384x512）	148	32x43mm	blue,white,red
教师资格证（360x480）	149	30x41mm	white
护士执业资格考试（120x160）	150	10x13mm	white
工商银行网申（100x140）	151	8x12mm	blue,white,red
建设银行网申	152	10x13mm	blue,white,red
中国人民银行网申	153	17x22mm	blue,white,red
工商银行网申（240x370）	154	20x31mm	blue,white,red
工商银行网申生活照	155	20x27mm	blue,white,red
中国银行	156	26x35mm	blue,white,red
中国交通银行	157	26x35mm	blue,white,red
中国储蓄银行	158	6x8mm	blue,white,red
金融服务师	159	8x12mm	blue
事业单位	160	10x13mm	blue,white,red
宁德事业单位	161	22x29mm	blue,blue_gradual
石家庄铁路职专毕业照	162	480x640，10-40KB	blue
上海事业单位	163	120x168px	blue,white,red
BIM技能等级考试	164	250x350，20-40KB	white
证券考试报名	165	215x300px	blue,white,red
英语四六级考试	166	33x48mm	blue,white
商务英语考试	167	25x34mm	blue,white
全国计算机等级考试	168	20x27mm	blue,white,red
山西省全国计算机等级考试	169	25x35mm	blue,white,red
河南计算机二级考试	170	33x48mm	blue,white,red
成人自考	171	30x41mm	blue
上海中考网报名	172	14x20mm	blue,white,red,blue_gradual
香港学生国内报名	173	14x20mm	blue,white,red,blue_gradual
武汉大学研究生考试	174	13x17mm	blue,white,red
中南财经政法大学入学考试报名	175	15x20mm	blue,white,red
厦门大学毕业证	176	39x54mm	blue,white,red
在职研究生考试	177	33x48mm	blue,red
江苏自考	178	30x41mm	blue,white,blue_gradual
驾驶证、驾照（无回执，一寸）	179	25x35mm	white
电子导游证	180	35x53mm	white
会计从业资格证	181	10x13mm	white
教师招聘报名	182	9x12mm	blue,white,red
特殊招聘要求	183	20x27mm	blue,white,red
育婴师考试报名（小二寸）	184	35x49mm	blue,white,red
一级注册消防工程师考试	185	25x35mm	blue,white,red
一级建造师	186	25x35mm	blue,white,red
职业医师注册	187	35x49mm	blue,white,red
初级护师	188	35x45mm	blue,white,red
国家医学考试	189	25x35mm	blue,white,red
职业医师资格证	190	25x35mm	blue,white,red
护士职业资格考试	191	14x18mm	blue,white,red
国家公务员考试	192	35x45mm	blue,white
国家公务员考试	193	35x49mm	blue,white
广州公务员考试	194	35x49mm	blue,white
重庆公务员考试	195	25x35mm	blue,white
黑龙江公务员考试	196	35x45mm	blue,white
云南公务员考试	197	35x45mm	blue,white
四川公务员考试	198	35x45mm	blue,white
广西公务员考试	199	25x35mm	blue,white
山西公务员考试	200	25x35mm	blue,white
河北公务员考试	201	35x45mm	blue,white
上海公务员考试	202	13x17mm	blue,white
宁夏公务员考试	203	35x45mm	blue,white
陕西公务员考试	204	35x45mm	blue,white
河南公务员考试	205	25x35mm	blue,white
江苏公务员考试	206	34x45mm	blue,white
安徽公务员考试	207	35x45mm	blue,white
湖南公务员考试	208	35x45mm	blue,white
北京公务员考试	209	35x53mm	blue,white
成都公务员考试	210	25x35mm	blue,white
甘肃公务员考试	211	35x49mm	blue,white
青海公务员考试	212	35x45mm	blue,white
新疆公务员考试	213	25x35mm	blue,white
西藏公务员考试	214	35x45mm	blue,white
三支一扶山东	215	25x35mm	blue,white
山西省省直事业单位考试报名	216	25x35mm	blue,white,red
全国计算机等级考试	217	35x49mm	blue,white,red
全国计算机等级考试	218	13x18mm	blue
青少年软件编程等级考试	219	41x62mm	blue,red
青少年机器人技术等级考试	220	41x62mm	blue,red
青少年电子信息等级考试	221	41x62mm	blue,red
计算机应用能力考试报名	222	25x35mm	white
退役军人优待证	223	30x37mm	white
注册会计师考试（102x126）	224	9x11mm	white
注册会计师考试（一寸）	225	25x35mm	white
大学生图像信息采集	226	41x54mm	blue
研究生考试	227	45x60mm	blue,white
高考报名（480x640）	228	41x54mm	blue,white,red,blue_grey
护士执业资格考试（一寸，大于45KB）	229	25 x 35 mm	blue,white