腾讯混元生视频数据结构

ExtraParam

扩展字段。

被如下接口引用：SubmitTemplateToVideoJob。

名称	类型	必选	描述
UserDesignatedUrl	String	否	预签名的上传url，支持把视频直接传到客户指定的地址。示例值：http://tencent.com/result/video.mp4

FaceMergeInfo

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

被如下接口引用：SubmitVideoFaceFusionJob。

名称	类型	必选	描述
MergeFaceImage	Image	否	融合图片
MergeFaceRect	FaceRect	否	上传的图片人脸位置信息（人脸框） Width、Height >= 30。
TemplateFaceID	String	否	素材人脸ID，不填默认取上传图片中最大人脸。示例值：1

FaceRect

人脸框信息。

被如下接口引用：SubmitVideoFaceFusionJob。

名称	类型	必选	描述
X	Integer	否	人脸框左上角横坐标。示例值：1
Y	Integer	否	人脸框左上角纵坐标。示例值：1
Width	Integer	否	人脸框宽度。示例值：30
Height	Integer	否	人脸框高度。示例值：30

FaceTemplateInfo

模板信息

被如下接口引用：SubmitVideoFaceFusionJob。

名称	类型	必选	描述
TemplateFaceID	String	否	角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字，建议填"0"、"1"，依次累加。示例值：0
TemplateFaceImage	Image	否	视频模板中要替换的人脸图片
TemplateFaceRect	FaceRect	否	视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。

Image

图片

被如下接口引用：SubmitHunyuanToVideoJob, SubmitImageToVideoGeneralJob, SubmitTemplateToVideoJob, SubmitVideoFaceFusionJob。

名称	类型	必选	描述
Base64	String	否	图片Base64 示例值：MIIHNjCCBh6gAwIBAgIQCVe4E0h49mzI0NcSqMy1
Url	String	否	图片Url 示例值：https://cos.ap-guangzhou.myqcloud.com/image.jpg

LogoParam

logo参数

被如下接口引用：SubmitHumanActorJob, SubmitHunyuanToVideoJob, SubmitImageAnimateJob, SubmitImageToVideoGeneralJob, SubmitPortraitSingJob, SubmitTemplateToVideoJob, SubmitVideoFaceFusionJob, SubmitVideoVoiceJob。

名称	类型	必选	描述
LogoUrl	String	否	水印 Url 示例值：https://cos.ap-guangzhou.myqcloud.com/logo.jpg
LogoImage	String	否	水印 Base64，Url 和 Base64 二选一传入，如果都提供以 Url 为准示例值：/9j/4QlQaHR0c...N6a2M5ZCI
LogoRect	LogoRect	否	水印图片位于生成结果图中的坐标及宽高，将按照坐标对标识图片进行位置和大小的拉伸匹配。示例值：{ "X": -222, "Y": -54, "Width": 202, "Height": 34 }

LogoRect

水印图输入框

名称	类型	必选	描述
X	Integer	否	水印图框X坐标值。当值大于0时，坐标轴原点位于原图左侧，方向指右；当值小于0时，坐标轴原点位于原图右侧，方向指左。示例值：-222
Y	Integer	否	水印图框Y坐标值。当值大于0时，坐标轴原点位于原图上侧，方向指下；当值小于0时，坐标轴原点位于原图下侧，方向指上。示例值：-54
Width	Integer	否	水印图框宽度。示例值：202
Height	Integer	否	水印图框高度。示例值：34

数据结构

本页目录：

ExtraParam

FaceMergeInfo

FaceRect

FaceTemplateInfo

Image

LogoParam

LogoRect