接口请求域名： facefusion.intl.tencentcloudapi.com 。
视频人脸融合异步处理任务，成功提交任务后返回任务的Job id 、预计完成时间以及目前队列长度。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：SubmitVideoFaceFusionJob。 |
| Version | 是 | String | 公共参数，本接口取值：2022-09-27。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| ProjectId | 是 | String | 活动 ID，请在视频人脸融合控制台查看。 ID，请在视频人脸融合控制台查看。 |
| ModelId | 是 | String | 素材 ID，请在视频人脸融合控制台查看。 |
| MergeInfos.N | 是 | Array of MergeInfo | 用户人脸图片、素材模板图的人脸位置信息。不能超过1个。 |
| CelebrityIdentify | 否 | Integer | 0表示不需要不适宜内容识别，1表示需要不适宜内容识别。默认值为0。请注意，不适宜内容识别服务开启后，您需要根据返回结果自行判断是否调整您的业务逻辑。例如提示您的用户图片非法，请更换图片。注意：因业务调整，此字段后面会下线，不建议使用。 |
| LogoParam | 否 | LogoParam | 视频水印Logo参数 |
| UserDesignatedUrl | 否 | String | 对象存储预签名地址(PUT方法)，填值则最终融合的视频上传到此地址。注意：如果此地址上传失败，则会返回腾讯侧默认兜底的地址。 |
| UserIp | 否 | String | 用户ip |
| MetaData.N | 否 | Array of MetaData | 元数据是描述媒体文件的附加信息。通过添加自定义的元数据，可以将一些附加信息嵌入到文件中。这些信息可以用于版权、描述、标识等目的，并在后续的媒体处理或管理过程中使用。 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| JobId | String | 视频人脸融合任务的Job id |
| EstimatedProcessTime | Float | 视频人脸融合任务预估处理时间，粒度为秒 |
| JobQueueLength | Integer | 视频人脸融合任务等待队列长度 |
| ReviewResultSet | Array of FuseFaceReviewResult | 不适宜内容识别结果。该数组的顺序和请求中mergeinfo的顺序一致，一一对应 注意：此字段可能返回 null，表示取不到有效值。 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: facefusion.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitVideoFaceFusionJob
<公共请求参数>
{
"ProjectId": "100646",
"MergeInfos": [
{
"Url": "https://i2.sinaimg.cn/ty/nba/2015-07-05/U10236P6T12D7648505F44DT20150705114547.jpg"
}
],
"ModelId": "qc_100646_154021_9"
}
{
"Response": {
"JobId": "C0a5EXaNR7JzGvlg",
"EstimatedProcessTime": 30,
"JobQueueLength": 1,
"ReviewResultSet": [
{
"Category": "Politics",
"Code": "0",
"CodeDescription": "OK",
"Suggestion": "PASS",
"Confidence": 30,
"DetailSet": [
{
"Field": "",
"Label": "丁俊晖",
"Confidence": 30,
"Suggestion": "PASS"
}
]
}
],
"RequestId": "83ecff39-2e4a-41d5-8562-1f8898326565"
}
}
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.BalanceInsufficient | 余额不足，开通失败，请充值后再开通。 |
| FailedOperation.FaceIdNotInVideo | 指定的人脸ID不存在视频中。 |
| FailedOperation.FaceSizeTooSmall | 人脸因太小被过滤，建议人脸分辨率不小于34*34。 |
| FailedOperation.FuseMaterialNotAuth | 素材未经过审核。 |
| FailedOperation.FuseMaterialNotAvailable | 素材状态不可用。 |
| FailedOperation.FuseMaterialNotExist | 素材不存在。 |
| FailedOperation.ImageDecodeFailed | 人脸检测-图片解码失败。 |
| FailedOperation.ImageDownloadError | 图片下载失败。 |
| FailedOperation.ImageResolutionExceed | 图片分辨率过大。建议您resize压缩到3k*3k以内。 |
| FailedOperation.ImageResolutionTooSmall | 图片短边分辨率小于64。 |
| FailedOperation.ImageSizeExceed | 输入图片base64数据大小超过5M。 |
| FailedOperation.ImageSizeInvalid | 图片尺寸过大或者过小；不满足算法要求。 |
| FailedOperation.InnerError | 服务内部错误。 |
| FailedOperation.NoFaceDetected | 无法检测出人脸, 人脸框配准分低于阈值。 |
| FailedOperation.ParameterValueError | 参数字段或者值有误。 |
| FailedOperation.ProjectNotAuth | 活动未支付授权费或已停用。 |
| FailedOperation.RequestTimeout | 后端服务超时。 |
| FailedOperation.RpcFail | RPC请求失败，一般为算法微服务故障。 |
| FailedOperation.UnKnowError | 内部错误。 |
| FailedOperation.Unknown | 未知错误。 |
| InvalidParameterValue.FaceRectParameterValueError | 人脸框参数有误或者人脸框太小。 |
| InvalidParameterValue.UrlIllegal | URL格式不合法。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceInsufficient | 资源不足。 |
| ResourceNotFound | 资源不存在。 |
| ResourceUnavailable.Freeze | 账号已被冻结。 |
| ResourceUnavailable.InArrears | 账号已欠费。 |
| ResourceUnavailable.IsOpening | 服务正在开通中，请稍等。 |
| ResourceUnavailable.NotExist | 计费状态未知，请确认是否已在控制台开通服务。 |
| ResourceUnavailable.Recover | 资源已被回收。 |
| ResourceUnavailable.StopUsing | 账号已停服。 |
文档反馈