描述

本接口用于证件照-图片制作的请求，具体效果请看以下文档详情。

版本

1.0

图片要求

图片格式：JPG，PNG

更新日志

调用 URL

正式环境：https://openapi.meitu.com/idphoto/business/v1/make

调用方法

POST

request 的头的类型应包含：Content-Type:application/json

权限

开放平台接口签名

请求参数

参数名称	类型	最大长度	是否必传	备注
out_request_id	string	64	是	外部请求ID（唯一）
img_url	string	200	否	图片URL（完整URL地址，需要urlencode处理）
name	string	20	是	证件照名称（如：一寸照）
back_color	string	7	是	背景颜色值，如：#357ec2
back_mode	int	-	是	背景模式：0纯色,1由上往下,2由外往内,3由内往外
size_unit	int	-	是	尺度单位：1=px, 2=mm，当为自定义证件照时必填
sd_width	int	-	是	标清宽度，单位:px
sd_height	int	-	是	标清高度，单位:px
sd_dpi	int	-	是	标清分辨率(dpi)
sd_size_min	int	-	是	标清文件大小，最小值，单位: kb
sd_size_max	int	-	是	标清文件大小，最大值，单位: kb
hd_dpi	int	-	是	高清分辨率(dpi) 一般建议传值1000
custom_watermark_vertical	string	200	否	自定义竖版水印标识（联系美图商务配置）
custom_watermark_transverse	string	200	否	自定义横版水印标识（联系美图商务配置）
face_switch	int	-	否	人脸框开关，1=开启，2=关闭（默认关闭）。开启时人脸参数才生效
face_top	int	-	否	头顶距离画面顶部高度top, 0≤ face_top ＜所制作寸照的高
face_width	int	-	否	人脸框脸宽度width, 0＜face_width ＜所制作寸照的宽
face_height	int	-	否	人脸框脸高度height, 0＜ face_height＜所制作寸照的高
mt_check_id	string	64	否	若合作方接入检测接口/idphoto/business/check ，会获取该接口所返回的检测标识；该标识可用于在其他图片制作接口中跳过图片上传与检测

注意： 1、img_url、mt_check_id必须且只能选择一个传入，接口会根据传入参数来选取制作图片； 2、该接口已内置了较为基础的图像检测能力；若合作方有更细化的检测需求，可接入检测接口/idphoto/business/check；

请求示例

{
    "back_color": "#00868B",
    "back_mode": 3,
    "hd_dpi":1000,
    "img_url": "https://481598.jpeg",
    "name": "295*413",
    "out_request_id":"36936",
    "sd_dpi": 300,
    "sd_height": 35,
    "sd_size_max": 6,
    "sd_size_min": 2,
    "size_unit": 2,
    "sd_width": 25,
	"mt_generate_id": "72039499999199999"
}

返回值说明

成功返回值说明

字段名称	类型	示例值	描述
code	int	100000	响应状态码
msg	string	操作成功	提示
data	object		数据
data.check_fail_item	string	无法识别,面部有遮挡	图片检测失败错误信息（多个错误会有逗号分隔）【图象检测失败时,给用户提示用】
data.mt_generate_id	string	6917420196238201565	美图证件照生成ID
data.sd_photo	string	http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627569878737-460912.jpg?xxxxxxxxx	标清图
data.hd_photo	string	http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627569878737-460912.jpg?xxxxxxxxx	高清图
data.typesetting_photo	string	http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627569878737-460912.jpg?xxxxxxx	排版图

失败返回值说明

字段	类型	说明
data	String	返回的内容
message	String	错误信息
code	Int	错误代码

返回值示例

请求成功返回示例

Response Status：200

content-type 为 application/json; charset=utf-8

{
    "code": 100000,
    "msg": "操作成功",
    "data": {
        "check_fail_msg": "",
        "mt_generate_id": "2329351846",
        "sd_photo": "http://biz-res-pre.zone1.meitudata.com/i0T242B5B786IvdMEigEjyE8=",
        "hd_photo": "http://biz-res-pre.zone1.meitudata.com/oken=MO2HHQCVI6TWO3RGWjyE8=",
        "typesetting_photo": "http://biz-res-pre.zone1.meitudata.com/i56fKhjxeTmUYEeG5jEdOM3Y="
    },
    "log_id": "Z7VX7Aw6pFtQ4md21VCdRlCXp3TByG99"
}

返回状态码

状态码	说明
100000	成功
100001	参数错误

错误代码与信息

1、本接口涉及扣费规则、错误码、msg等内容的说明，详见扣费&状态码说明