图片脸部替换
Action SwitchFace
简介
此接口用于替换图片中的人脸。
请求
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| Action | String | 对应的 API 指令名称 | ✓ |
| PublicKey | String | 用户公钥，可从 PICPIK用户中心 (opens in a new tab) 获取 | ✓ |
| Signature | String | 根据公钥及 API 指令生成的用户签名，参见 签名算法 | ✓ |
| request_uuid | String | 请求uuid，采用uuid生成方式随机生成，可用于管理您业务和客户的请求 |
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| RawImage | Base64 | 需要被替换脸部的图片Base64 | ✓ |
| RawFaceIndex | Int | 需要替换第几张脸(1~100)，默认值:1 | |
| NewFaceImage | Base64 | 新的脸部图片的Base64 | ✓ |
请求示例
{
"Action": "SwitchFace",
"PublicKey": "ALLak9M4cNdHXKOJAJJ4k8Hh1hZS2EgJF1D0FlPwfl",
"Signature": "e5f881d1b60b8fbcbdfb0621c4f25834f24121dd",
"request_uuid": "0ec48649-44d1-49ed-80ab-9c905dd7a65b",
"RawImage": "data:image/jpeg;base64,xxx",
"NewFaceImage": "data:image/jpeg;base64,bbb",
"RawFaceIndex": 1
}响应
| 字段名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| RetCode | Int | 返回状态码，为 0 则为成功返回，非 0 为失败 | ✓ |
| Action | String | 操作指令名称 | ✓ |
| Message | String | 返回错误消息，当 RetCode 非 0 时提供详细的描述信息 | |
| request_uuid | String | 返回请求时填写的uuid |
| 参数名 | 类型 | 描述信息 | 必填 |
|---|---|---|---|
| TaskUID | String | 任务UID，用于查询任务详情与获取结果 | ✓ |
响应示例
{
"Action": "SwitchFace",
"RetCode": 0,
"Message": "",
"request_uuid": "8482d350-04f9-421b-817b-1d98b3a4dcfa",
"TaskUID": "cktlm6lrh4miq8ng9nf0"
}