生产环境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 (视频融合队列Id) |
| true | Long | 数字人平台获取 | ||
faceUrl | 单人换脸图片 url | false | String | 单人脸必传 | |||
faceUrls | 多人换脸图片 url | false | Array | 多人脸必传 | |||
templateFaceUrls | 多人被视频模板中要替换的人脸图片url(顺序要与faceUrls对应) |
| 多人被视频模板中要替换的人脸图片url(顺序要与faceUrls对应) | false | Array | 多人脸必传 | |
videoUrl | 视频地址 |
| true | String |
| ||
requestId | 请求id 请求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 | 原请求requestId | body | true | long |
| ||
videoUrl | 生成视频地址 | body | true | string |
| ||
success | 是否成功 | body | true |
|
| ||
failMsg | 失败原因 | body | false |