腾讯混元生视频快速入门

一、准备工作

在使用腾讯混元生视频服务前，你需要先注册腾讯云账号。如果没有账号，请参考注册腾讯云教程。

二、1. 开通腾讯混元生视频服务

注册并通过实名认证后，登录腾讯混元生视频控制台，阅读和同意相关服务协议，并单击开通，即可开通服务。

三、2. 获取密钥信息

密钥是指：SecretId 和 SecretKey，为降低密钥泄露的风险，自2023年11月30日起，对所有主账号、子账号的密钥，关闭查询 SecretKey 的功能，仅支持在创建时查看，请及时保存 SecretKey 。如果忘记 SecretKey ，可以删除密钥之后重新创建一个。

注意：说明：

四、3. 调用 API 接口（示例）

因视频风格化接口是异步接口，需调用提交视频风格化任务跟查询视频风格化任务2个接口。

序号	接口	说明
1	提交图生视频任务	输入文字或图片后提交请求，请求成功会返回一个 JobId 。
2	查询图生视频任务	通过提交生视频任务返回的 JobId 去查询结果信息。

五、方式一：通过 API Explorer 在线调用接口

调用提交视频风格化任务接口：输入参数之后点击发起调用，会返回提交视频风格化任务的结果信息。

注意：说明：

注意：对应参数说明可前往 API 接口文档查看。

成功结果参考：请求成功会返回 JobId 和 RequestId 。

失败结果参考：请求失败会返回失败的 Code 和 Message 。

{ "Response": { "Error": { "Code": "FailedOperation.DownloadError", "Message": "视频下载失败。" }, "RequestId": "01472513-a21b-4bfa-a816-4623459cb1d5" }}

六、Running Environment

Operating System: Ubuntu 24.04.2 LTS / x86_64Runtime Version: Python 3.11.1

调用查询视频风格化任务接口：通过提交生视频任务成功的 JobId 获取结果信息。

任务状态说明：

·JobInit：初始化中。

·JobModerationFailed：审核失败。

·FAIL：任务失败。

·DONE：任务成功。

提交查询的时候会返回 StatusCode（任务状态），当 StatusCode 为 JobRunning、JobSuccess 和 JobModerationFailed 的时候，表示任务已经处理完成。

·如果 StatusCode 为 JobSuccess：可以通过返回的 ResultVideoUrl 参数获取到结果视频。

·如果 StatusCode 为 JobFailed 或者 JobModerationFailed：可以通过返回的 ErrorCode 参数跟 ErrorMessage 参数获取报错原因。

·如果 StatusCode 为 JobInit 或者 JobRunning：则表示没有拉取到结果信息，需要继续拉取。

返回成功结果：

{ "Response": { "JobId": "26cb7ffd380d4829bec7632589855719", "RequestId": "569b9d01-d29b-49a9-9562-d195d955c237", "ResultVideoUrl": "https://vcg-prod-***.cos.ap-guangzhou.tencentcos.cn/***.mp4", "StatusCode": "JobSuccess", "StatusMsg": "处理完成" }}

七、Running Environment

Operating System: Ubuntu 24.04.2 LTS / x86_64Runtime Version: Python 3.11.1

八、方式二：安装 SDK 调用接口

点击代码示例，可以查询到目前可以安装 sdk 的开发语言，选择安装对应版本的 sdk 进行调用：

腾讯混元生视频 快速入门