生产环境HOST:https://digitalman.h5no1.com
测试环境HOST:https://test.digitalman.h5no1.com
使用场景:
对接数字人开放平台,视频人脸融合。
接口地址 /open/platform/queueDigital/videoFaceFusion
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 视频人脸融合,
请求参数
查询条件
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注 |
resourceConfigId | 数字人平台资源队列配置id (视频融合队列Id) |
| true | Long | 数字人平台获取 |
faceUrl | 单人换脸图片 url |
| false | String | 单人脸必传 |
faceUrls | 多人换脸图片 url |
| false | Array | 多人脸必传 |
templateFaceUrls | 多人被视频模板中要替换的人脸图片url(顺序要与faceUrls对应) |
| false | Array | 多人脸必传 |
videoUrl | 视频地址 |
| true | String |
|
requestId | 请求id (唯一) |
| true | Long | 随机数 |
callBackUrl | 回调地址 |
| true | String |
|
请求示例
https://digitalman.h5no1.com/open/platform/queueDigital/videoFaceFusion
{
"resourceConfigId": 204978205090403328,
"faceUrl": "https://rabbitlab-cdn.h5no1.com/rabbitlab-2d-1251517970/opera/118f1711722c43d488e28e78746d8032.jpg",
"videoUrl": "https://meishecutter-cdn.test.rabbitpre.com/editor/2024/01/09/video-compiled/5f7d4c4a34234e2daacf73025ecd604c/5f7d4c4a34234e2daacf73025ecd604c.mp4",
"requestId": 1744902414138286080,
"callBackUrl": "https://ai-opera-test.gztzai.com/aiOpera/callback/faceFusionVideo"
}
响应参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
code | 状态码 | body | true | string |
|
showMsg | 错误描述 | body | true | string |
|
errorMsg | 错误描述 对开放者 | body | true | string |
|
data | 响应数据 | body | true | object |
|
响应状态
状态码 | 说明 | schema |
0 | OK |
|
响应示例
{
"code": "0",
"showMsg": null,
"errorMsg": null,
"requestId":"16922526314039707",
"data": null
}
回调接口说明
因为视频融合时间较长,融合接口是异步形式,开发者需要提供回调接口接收视频融合结果。
接口请求方式 POST
consumes ["application/json"]
produces ["application/json"]
VideoCallBack数据
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
taskId | 原请求requestId | body | true | long |
|
videoUrl | 生成视频地址 | body | true | string |
|
success | 是否成功 | body | true |
|
|
failMsg | 失败原因 | body | false |
|