tencent cloud

人脸融合

文档人脸融合API 文档数据结构

数据结构

下载
聚焦模式
字号
最后更新时间： 2026-05-26 23:13:29

FaceRect

人脸框信息

被如下接口引用：FuseFace, SubmitVideoFaceFusionJob。

名称 类型 必选 描述
X Integer 是

人脸框左上角横坐标。


注意：此字段可能返回 null，表示取不到有效值。
Y Integer 是

人脸框左上角纵坐标。


注意：此字段可能返回 null，表示取不到有效值。
Width Integer 是

人脸框宽度。
单位：px


注意：此字段可能返回 null，表示取不到有效值。
Height Integer 是

人脸框高度。
单位：px


注意：此字段可能返回 null，表示取不到有效值。

FuseFaceReviewDetail

人脸融合不适宜内容识别人脸信息

被如下接口引用：SubmitVideoFaceFusionJob。

名称 类型 描述
Field String 保留字段
Label String 审核命中的标签名词
Confidence Float 对应识别label的置信度，分数越高意味违法违规可能性越大。
0到70，Suggestion建议为PASS；
70到80，Suggestion建议为REVIEW；
80到100，Suggestion建议为BLOCK。
Suggestion String 识别场景的审核结论：
PASS：正常
REVIEW：疑似
BLOCK：违规

FuseFaceReviewResult

人脸融合不适宜内容识别返回参数item

被如下接口引用：SubmitVideoFaceFusionJob。

名称 类型 描述
Category String 保留字段
Code String 状态码， 0为处理成功，其他值为处理失败
CodeDescription String 对应状态码信息描述
Confidence Float 保留字段
Suggestion String 保留字段
DetailSet Array of FuseFaceReviewDetail 审核详细内容

FuseParam

融合参数

被如下接口引用：FuseFace。

名称 类型 必选 描述
ImageCodecParam ImageCodecParam 否 图片编码参数

ImageCodecParam

图片编码参数

被如下接口引用：FuseFace。

名称 类型 必选 描述
MetaData Array of MetaData 否 元数据是描述媒体文件的附加信息。通过添加自定义的元数据，可以将一些附加信息嵌入到文件中。这些信息可以用于版权、描述、标识等目的，并在后续的媒体处理或管理过程中使用。
个数不能大于1。

LogoParam

logo参数

被如下接口引用：FuseFace, SubmitVideoFaceFusionJob。

名称 类型 必选 描述
LogoRect FaceRect 是 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配。
Width、Height <= 2160。
LogoUrl String 否 标识图片Url地址

●base64 和 url 必须提供一个，如果都提供以 url 为准。
●支持图片格式：支持jpg或png
专业版：base64 编码后大小不超过10M。
非专业版：base64 编码后大小不超过5M。
LogoImage String 否 输入图片base64。
●base64 和 url 必须提供一个，如果都提供以 url 为准。
●支持图片格式：支持jpg或png
专业版：base64 编码后大小不超过10M。
非专业版：base64 编码后大小不超过5M。

MergeInfo

人脸图片和待被融合的素材模板图的人脸位置信息。

被如下接口引用：FuseFace, SubmitVideoFaceFusionJob。

名称 类型 必选 描述
Image String 否 输入图片base64。
●base64 和 url 必须提供一个，如果都提供以 url 为准。
●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
●支持图片格式：支持jpg或png
Url String 否 输入图片url。
●base64 和 url 必须提供一个，如果都提供以 url 为准。
●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
●支持图片格式：支持jpg或png
InputImageFaceRect FaceRect 否 上传的图片人脸位置信息（人脸框）
Width、Height >= 30。
TemplateFaceID String 否 素材人脸ID，不填默认取最大人脸。
TemplateFaceRect FaceRect 否 模板中人脸位置信息(人脸框)，不填默认取最大人脸。此字段仅适用于图片融合自定义模板素材场景。
Width、Height >= 30。

MetaData

MetaData数据结构，Key/Value格式

被如下接口引用：FuseFace, SubmitVideoFaceFusionJob。

名称 类型 必选 描述
MetaKey String 是 MetaData的Key，字符长度不能超过32
MetaValue String 是 MetaData的Value，字符长度不能超过256

VideoFaceFusionOutput

视频人脸融合返回结果

被如下接口引用：QueryVideoFaceFusionJob。

名称 类型 描述
VideoUrl String 视频人脸融合输出的视频url地址
VideoMD5 String 视频人脸融合输出的视频MD5，用于校验
Width Integer 视频宽度
Height Integer 视频高度
FPS Integer 每秒传输帧数
DurationInSec Float 视频播放时长，单位为秒
Frame Integer 帧数
上一篇: 查询视频人脸融合任务下一篇: 错误码

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈