当前位置：首页 > article >正文

官方换装规格，多种。支持证件照制作的api接口

article 2025/2/24 20:53:00

预览：证寸照制作

美颜、排版、换装、黑白图片上色等接口api调用演示示例。

制作证件照免费制作使用。

对应的api接口代码：

证件照检测+制作（有水印）

接口地址：https://api.zheyings.cn/idcardv5/make

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：调用免费，可使用接口返回的"pic_id"获取无水印证件照

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	规格id，《查看规格列表》
image	是	string	base64后的图片内容
colors	否	string	颜色名称，支持：blue、white、red、tint、grey、gradient、dark_blue,不填写返回所有底色
enhance	否	int	人像增强，默认已支持，不需要可传参数0
beauty	否	int	美颜，默认已支持，不需要可传参数0

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "list": {
             "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

证件照换装（有水印）

接口地址：https://api.zheyings.cn/idcardv5/clothes

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：调用免费，可使用接口返回的"pic_id"获取无水印证件照；更换底色、自定义制作现已支持换装。

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
pic_id	是	string	制作接口返回的“pic_id”
color	是	string	颜色名称
clothes	是	string	服装key，《查看服装列表》

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "pic": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg",
        "clothes_key": "blue-child_09"
    },
    "code": 0,
    "msg": "success"
}

证件照检测+制作（无水印）

接口地址：https://api.zheyings.cn/idcardv5/all

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：获取成功扣除0.6元

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	规格id，《查看规格列表》
image	是	string	base64后的图片内容
colors	否	string	颜色名称，支持：blue、white、red、tint、grey、gradient、dark_blue
enhance	否	int	人像增强，默认已支持，不需要可传参数0
beauty	否	int	美颜，默认已支持，不需要可传参数0

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "list": {
             "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

图片检测+更换底色（有水印）

接口地址：https://api.zheyings.cn/idcardv5/bg

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：调用免费，可使用接口返回的"pic_id"获取无水印证件照。

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	5000
image	是	string	base64后的图片内容，大小不超过3M，分辨率不超过2000px。
color	否	string	颜色值（#FFFFFF）；或颜色名称（blue、white、red）
enhance	否	int	人像增强，默认已支持，不需要可传参数0
beauty	否	int	美颜，默认已支持，不需要可传参数0

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "list": {
             "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

证件照检测+自定义制作（有水印）

接口地址：https://api.zheyings.cn/idcardv5/diy

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：调用免费，可使用接口返回的"pic_id"获取无水印证件照。

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	6000
image	是	string	base64后的图片内容
width_px	是	int	像素尺寸-宽，不超2000px
height_px	是	int	像素尺寸-高，不超2000px
color	是	string	颜色值（#FFFFFF）；或颜色名称（blue、white、red）
file_size_min	否	int	文件最小（kb），最小5kb
file_size_max	否	int	文件最大（kb），最大600kb
dpi	否	int	分辨率：默认为300
enhance	否	int	人像增强，默认已支持，不需要可传参数0
beauty	否	int	美颜，默认已支持，不需要可传参数0

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "list": {
             "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

职业形象照（有水印）

接口地址：https://api.zheyings.cn/idcardv5/make

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：调用免费，可使用接口返回的"pic_id"获取无水印证件照

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
item_id	是	int	规格id，《查看规格列表》
image	是	string	base64后的图片内容
colors	否	string	颜色名称，支持：pose_black、pose_blue、pose_darkgray、pose_gray、pose_white,不填写返回所有底色
enhance	否	int	人像增强，默认已支持，不需要可传参数0
beauty	否	int	美颜，默认已支持，不需要可传参数0

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "pic_id": "9244614",
        "list": {
             "pose_blue": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

获取证件照（无水印）

接口地址：https://api.zheyings.cn/idcardv5/get

请求方式：POST(application/x-www-form-urlencoded)

返回格式：json

接口费用：获取成功扣除0.6元，重复获取不扣费。

请求参数：

名称	必填	类型	说明
key	是	string	应用的key
pic_id	是	string	制作接口返回的pic_id，有效期50分钟。
clothes_key	否	string	换装接口返回的clothes_key，有效期50分钟。

返回参数：

名称	类型	说明
code	int	状态码
msg	string	返回说明
data	array	数据集

JSON返回示例：

{
    "data": {
        "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
    },
    "code": 0,
    "msg": "success"
}