# 视频换脸-API接入
根据选择的视频模板以及对应的脸部编号, 加上用户自行上传图片内容进行人脸替换操作
# 任务创建
根据输入参数创建算法任务并返回任务id
# 请求地址
/v3/pic/vfs/batch
# 请求参数
Method
post
Header
| Field | Required | Type | Value | Description |
|---|---|---|---|---|
| Content-Type | YES | string | application/json | |
| Authorization | YES | string | Basic xxxxxxxxx | 用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret) |
Body
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| template_name | - | YES | string | 换脸模板id | |
| target_face_list | - | YES | string | 换脸模板id | |
| - | 0(依次类推) | YES | string | 对应脸部编号的换脸内容 |
template_name
| template_name | 效果 | 脸部id |
|---|---|---|
| 2161 | 0 | |
| 2162 | 0 | |
| 2164 | 0 | |
| 2165 | 0 | |
| 2166 | 0 | |
| 2167 | 0 | |
| 2168 | 0 | |
| 2169 | 0 | |
| 2170 | 0 | |
| 2171 | 0 |
示例代码 以下示例是将2161号模板的第0号脸替换为目标图片中的人脸
{
"template_name": "2161",
"target_face_list": {
"0": "https://ailab-storage-alisz.oss-cn-shenzhen.aliyuncs.com/linhui/talking_face/0519057.jpg?OSSAccessKeyId=LTAI5tEbdrxALVqaoYpqx49o&Expires=1721392248&Signature=Bemd0Z%2Byj4Y%2F0RIRgIzeZ7USd4A%3D"}
}
# 返回数据
Body
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| code | - | YES | number | 状态码, 490027:余额不足错误 | |
| msg | - | YES | string | 请求信息 | |
| data | - | YES | object | 响应数据 | |
| - | task_id | YES | string | 任务id |
示例代码
{
"code": 0,
"msg": "",
"data": {
"task_id": "6a4eab77-be30-430a-bf0e-3048042a34ef"
}
}
# 结果获取
根据任务id 请求任务处理结果
# 请求地址
/v3/pic/vfs/result/{task_id}
# 请求参数
Method
get
Header
| Field | Required | Type | Value | Description |
|---|---|---|---|---|
| Content-Type | YES | string | application/json | |
| Authorization | YES | string | Basic xxxxxxxxx | 用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret) |
路径参数
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| task_id | - | YES | string | 任务id |
# 返回数据
Body
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| code | - | YES | number | 状态码 | |
| msg | - | YES | string | 请求信息 | |
| data | - | YES | object | 响应数据 | |
| - | status | YES | string | 任务状态 状态：1- 等待中；2-进行中；3-任务完成；4-任务失败；5-任务关闭 6-任务超时 7-余额不足 8-内容敏感 | |
| - | wait_time | YES | string | 等待时间 | |
| - | reason | YES | string | 失败原因 | |
| - | result | YES | string | 结果url地址 |
← 简介