文档中心

图像生成大模型

视频改口型

接口文档

接口简介

视频改口型是指输入一段单人口播视频 + 音频，即可在在保留说话人形象特点的前提下，将视频中的人物口型根据指定的音频输入进行修改

请求说明

名称	内容
接口地址	https://visual.volcengineapi.com
请求方式	POST
Content-Type	application/json

提交任务

提交任务请求参数

Header参数

注意

本服务固定值：Region为cn-north-1，Service为cv

主要用于鉴权，详见公共参数 - 签名参数 - 在Header中的场景部分

Query参数

拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSubmitTask&Version=2022-08-31

参数	可选/必选	类型	说明
Action	必选	String	接口名，取值：CVSubmitTask
Version	必选	String	版本号，取值：2022-08-31

Body参数

注意

业务请求参数，放到request.body中，MIME-Type为application/json

名称	类型	必选	描述	备注
req_key	string	是	服务标识 Lite模式：realman_change_lips Basic模式：realman_change_lips_basic_chimera
url	string	是	视频素材的url
pure_audio_url	string	是	纯人声音频url	音频地址，建议URL中不要包含中文，如果有中文调用前置进行unicode编码
separate_vocal	bool	否	是否打开人声分离，开启后会抑制音频背景杂音默认值：false
open_scenedet	bool	否	是否打开场景切分与说话人识别（仅对Basic模式生效）开启后如果模版视频中的人物没有说话，是背景音中有其他人说话，那么在驱动的时候，对应片段人物将不会驱动口型。默认值：false
align_audio	bool	否	是否开启视频循环（仅对Lite模式生效）当驱动音频时长大于模版视频时长时，开启后默认打开视频正循环，视频结束后从头开始循环。默认值：true
align_audio_reverse	bool	否	是否开启倒放循环（仅对Lite模式生效，开启此参数需要同时开启align_audio参数）。开启后视频循环流程为：正放->倒放->正放->......，可以解决视频循环播放时衔接处跳变的问题。默认值：false
templ_start_seconds	float	否	模版视频开始时间（仅对Lite模式生效）默认值：0

提交任务返回参数

通用返回参数

请参考通用返回字段及错误码

业务返回参数

重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)

字段	类型	说明
task_id	string	任务ID，用于查询结果

提交任务请求&返回完整示例

请求示例：

返回示例：

查询任务

查询任务请求参数

Header参数

注意

本服务固定值：Region为cn-north-1，Service为cv

主要用于鉴权，详见公共参数 - 签名参数 - 在Header中的场景部分

Query参数

拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVGetResult&Version=2022-08-31

参数	可选/必选	类型	说明
Action	必选	String	接口名，固定值：CVGetResult
Version	必选	String	版本号，固定值：2022-08-31

Body参数

注意

业务请求参数，放到request.body中，MIME-Type为application/json

参数	可选/必选	类型	说明	示例
req_key	必选	String	服务标识 Lite模式：realman_change_lips Basic模式：realman_change_lips_basic_chimera
task_id	必选	String	任务ID，此字段的取值为提交任务接口的返回
req_json	可选	JSON String	json序列化后的字符串,目前支持隐性水印配置，可在返回结果中添加	示例："{\"aigc_meta\": {\"content_producer\": \"xxxxxx\", \"producer_id\": \"xxxxxx\", \"content_propagator\": \"xxxxxx\", \"propagate_id\": \"xxxxxx\"}}"

ReqJson(序列化后的结果再赋值给req_json)

配置信息

参数	类型	可选/必选	说明
aigc_meta	AIGCMeta	可选	隐式标识（默认不添加隐式标识）	隐式标识验证方式： https://www.gcmark.com/web/index.html#/mark/check/video 验证，先注册帐号上传打标后的视频点击开始检测输出检测结果如下图即代表成功

AIGCMeta

隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》

名称	类型	可选/必选	描述
content_producer	string	可选	内容生成服务ID（长度 <= 256字符）
producer_id	string	必选	内容生成服务商给此视频数据的唯一ID（长度 <= 256字符）
content_propagator	string	必选	内容传播服务商ID（长度 <= 256字符）
propagate_id	string	可选	传播服务商给此视频数据的唯一ID（长度 <= 256字符）

查询任务返回参数

通用返回参数

请参考通用返回字段及错误码

业务返回参数

说明

重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)

参数名	类型	参数说明	参数示例
url	string	结果视频url	"resp_data": "{\"progress\": 100, \"received_at\": 1740109768.1251833, \"processed_at\": 1740109768, \"finished_at\": 1740109924, \"code\": 0, \"msg\": \"success\", \"vid\": \"v02e4dg10000curvgofog65u5bhke820\", \"vid_info\": {\"Vid\": \"v02e4dg10000curvgofog65u5bhke820\", \"VideoMeta\": {\"Uri\": \"tos-cn-v-41f16e/owVxgeIeEAAgYWsgAQfY8AAcfDzM3XxDfQ54om\", \"Height\": 1920, \"Width\": 1080, \"OriginHeight\": 1920, \"OriginWidth\": 1080, \"Duration\": 12.64, \"Bitrate\": 25827046, \"Md5\": \"9f5b99c772f6093fe69427a1888137f3\", \"Format\": \"MP4\", \"Size\": 40806733, \"FileType\": \"video\", \"Codec\": \"h264\"}, \"WorkflowInput\": {\"TemplateId\": \"\"}, \"GetPosterMode\": \"sync\"}, \"url\": \"https://xxxx\", \"text_after_translate\": null, \"audio_after_translate\": null, \"resource_id\": null, \"face_bbox\": null}" 视频链接（有效期为 1 小时）
aigc_meta_tagged	bool	隐式标识是否打标成功
status	string	任务状态	in_queue：任务已提交 generating：任务已被消费，处理中 done：处理完成，成功或者失败，可根据外层code&message进行判断 not_found：任务未找到，可能原因是无此任务或任务已过期(12小时) expired：任务已过期，请尝试重新提交任务请求