描述

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

版本

1.0

图片要求

图片格式：JPG，PNG

更新日志

调用 URL

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

调用方法

POST

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

权限

开放平台接口签名

请求参数

参数名称	类型	最大长度	是否必传	备注
out_request_id	string	64	是	外部请求ID（唯一）
mt_generate_id	string	19	是	美图证件照生成ID
custom_watermark_vertical	string	200	否	自定义竖版水印标识，适用于寸照（联系美图商务配置）
custom_watermark_transverse	string	200	否	自定义横版水印标识，适用于寸照（联系美图商务配置）

请求示例

{
    "mt_generate_id":"1712652640552366000",
    "out_request_id":"36936"
}

返回值说明

成功返回值说明

字段名称	类型	示例值	描述
code	int	100000	响应状态码
msg	string	操作成功	提示
data	object		数据
data.mt_generate_id	string		美图证件照生成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?xxxxxxxxx	排版照

失败返回值说明

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

返回值示例

请求成功返回示例

Response Status：200

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

{
  "code": 100000,
  "data": {
    "mt_generate_id": "6917420196238201568",
    "sd_photo": "http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627572213824-781934.jpg",
	"hd_photo": "http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627572213824-781934.jpg",
	"typesetting_photo": "http://biz-res-pre.zone1.meitudata.com/idphoto-private/1646220627569878737-460912.jpg"
  },
  "msg": "success"
}

返回状态码

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

错误代码与信息

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