快速入门

最近更新时间:2025-09-09 18:04:42

我的收藏

操作场景

本文将为您介绍如何使用 API 3.0 Explorer 在线调试腾讯混元生视频相关接口。

准备工作

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

操作步骤

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

注册并通过实名认证后,登录 腾讯混元生视频控制台,阅读和同意相关服务协议,并单击开通,即可开通服务。
密钥是指:SecretId 和 SecretKey,为降低密钥泄露的风险,自2023年11月30日起,对所有主账号、子账号的密钥,关闭查询 SecretKey 的功能,仅支持在创建时查看,请及时保存 SecretKey 。如果忘记 SecretKey ,可以删除密钥之后重新创建一个。
说明:
子账户调用需要主账户授权才可以使用,主账户登录之后点击用户列表,在对应的子账户后面选择授权,会弹出关联策略的弹窗,输入授权策略名称之后搜索,选择对应的策略点击确认。
授权策略:QcloudVCLMFullAccess


3. 调用 API 接口(示例)

因视频风格化接口是异步接口,需调用提交视频风格化任务跟查询视频风格化任务2个接口。
序号
接口
说明
1
提交视频风格化任务
输入风格与视频 URL 之后提交请求,请求成功会返回一个 JobId 。
2
查询视频风格化任务
通过提交风格化任务返回的 JobId 去查询结果信息。

方式一:通过 API Explorer 在线调用接口

调用提交视频风格化任务接口:输入参数之后点击发起调用,会返回提交视频风格化任务的结果信息。
说明:
对应参数说明可前往 API 接口文档 查看。
成功结果参考:请求成功会返回 JobId 和 RequestId 。

失败结果参考:请求失败会返回失败的 Code 和 Message 。
{
"Response": {
"Error": {
"Code": "FailedOperation.DownloadError",
"Message": "视频下载失败。"
},
"RequestId": "01472513-a21b-4bfa-a816-4623459cb1d5"
}
}



调用查询视频风格化任务接口:通过提交视频风格化任务成功的 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": "处理完成"
}
}




方式二:安装 SDK 调用接口

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