照相馆-人像换脸
描述
本接口用于照相馆-Ai换脸的请求，具体效果请看以下文档详情。
版本
1.0
图片要求
图片格式：JPG，PNG
更新日志
调用 URL
正式环境：https://openapi.meitu.com/idphoto/business/v2/faceswap/make
调用方法
POST
request 的头的类型应包含：Content-Type:application/json
权限
请求参数
| 参数名称 | 类型 | 最大长度 | 是否必传 | 备注 |
|---|---|---|---|---|
| out_request_id | string | 200 | 是 | 外部请求ID（唯一） |
| img_url | string | 200 | 否 | 图片URL（完整URL地址,需要urlencode处理） |
| template_id | integer | 20 | 是 | 模板id (提前下发到商户) |
| mt_check_id | string | 64 | 否 | 若合作方接入检测接口/idphoto/business/check ，会获取该接口所返回的检测标识；该标识可用于在其他图片制作接口中跳过图片上传与检测 |
注意：
- img_url、mt_check_id 必须且只能选择一个传入，接口会根据传入参数来选取制作图片；
- 该接口已内置了较为基础的图像检测能力；若合作方有更细化的检测需求，可接入检测接口
/idphoto/business/check。
请求示例
{
"out_request_id":"36936",
"img_url":"https://1712729785284668164-674060.jpeg",
"template_id": 100003,
"mt_check_id":"728888888888888"
}返回值说明
成功返回值说明
| 字段名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | integer | 100000 | 响应状态码 |
| msg | string | 操作成功 | 响应状态码说明 |
| data | object | 响应数据 | |
| data.face_url | string | 换脸图url(注意：由于图片为私有云，图片有效期为5分钟) | |
| data.mt_generate_id | string | 美图生成id |
失败返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| data | String | 返回的内容 |
| message | String | 错误信息 |
| code | Int | 错误代码 |
返回值示例
请求成功返回示例
Response Status：200
content-type 为 application/json; charset=utf-8
{
"code": 100000,
"msg": "操作成功",
"data": {
"face_url": "http:/.jpg",
"mt_generate_id":"123321"
},
"log_id": "Z7VX7Aw6pFtQ4md21VCdRlCXp3TByG99"
}返回状态码
| 状态码 | 说明 |
|---|---|
| 100000 | 成功 |
| 100001 | 参数错误 |
错误代码与信息
1、本接口涉及扣费规则、错误码、msg等内容的说明，详见 扣费&状态码说明