文档中心

智能视觉服务

单图音频驱动

调用步骤2：视频生成

接口简介

使用步骤1中生成的数字形象，请求此接口进行视频生成

请求说明

名称	内容
接口地址	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	是	服务标识普通模式：realman_avatar_picture_v2 灵动模式：realman_avatar_picture_loopy 大画幅灵动模式：realman_avatar_picture_loopyb
audio_url	string	是	音频链接
resource_id	string	是	形象id	创建形象接口返回的形象id

提交任务返回参数

通用返回参数

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

业务返回参数

重点关注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	服务标识普通模式：realman_avatar_picture_v2 灵动模式：realman_avatar_picture_loopy 大画幅灵动模式：realman_avatar_picture_loopyb
task_id	必选	String	任务ID，此字段的取值为提交任务接口的返回

查询任务返回参数

通用返回参数

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

业务返回参数

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

参数名	类型	参数说明	参数示例
preview_url	String	视频链接（有效期为 1 小时）当选用普通模式与loopy 模式时，视频链接会通过resp_data字符串中的preview_url字段返回	"resp_data": "{\"progress\": 100, \"received_at\": 1737685255, \"processed_at\": 1737685255, \"finished_at\": 1737685270, \"binary_data_url_list\": [], \"binary_data_info_list\": [], \"code\": 0, \"msg\": \"success\", \"video\": {\"Vid\": \"v024e3g10004cu9fi57og65j1a1656tg\", \"VideoMeta\": {\"Uri\": \"tos-cn-v-70bec6/o0RFI2FQAQCUdNslAADRIkkmNFngeBEOAvETfP\", \"Height\": 654, \"Width\": 570, \"OriginHeight\": 654, \"OriginWidth\": 570, \"Duration\": 4.267, \"Bitrate\": 610967, \"Md5\": \"ddda78bc8fd10978d4eab3b389c3217a\", \"Format\": \"MP4\", \"Size\": 325875, \"FileType\": \"video\", \"Codec\": \"h264\"}, \"GetPosterMode\": \"sync\"}, \"alpha\": null, \"url\": null, \"algorithm_status_code\": 0, \"preview_url\": [\"https:xxxx\"]}"
video_url	String	视频链接（有效期为 1 小时）当选用loopy 大画幅模式时，视频链接会通过video_url字符串返回	"video_url": "https://xxxx"
status	String	任务状态 in_queue：任务已提交 generating：任务已被消费，处理中 done：处理完成，成功或者失败，可根据外层code&message进行判断 not_found：任务未找到，可能原因是无此任务或任务已过期(12小时) expired：任务已过期，请尝试重新提交任务请求

查询任务请求&返回完整示例

请求示例：

返回示例：

普通模式与loopy 模式

loopy 大画幅模式

错误码

通用错误码

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

业务错误码

暂无，待补充

接入说明

SDK使用说明

请参考SDK使用说明

HTTP方式接入说明

请参考HTTP请求示例

最近更新时间：2025.06.09 11:44:37

这个页面对您有帮助吗？

有用

无用