操作场景
本文将为您介绍如何使用 API 3.0 Explorer 在线调试腾讯混元生视频相关接口。
准备工作
操作步骤
1. 开通腾讯混元生视频服务
2. 获取密钥信息
密钥是指:SecretId 和 SecretKey,为降低密钥泄露的风险,自2023年11月30日起,对所有主账号、子账号的密钥,关闭查询 SecretKey 的功能,仅支持在创建时查看,请及时保存 SecretKey 。如果忘记 SecretKey ,可以删除密钥之后重新创建一个。
说明:
子账户调用需要主账户授权才可以使用,主账户登录之后点击用户列表,在对应的子账户后面选择授权,会弹出关联策略的弹窗,输入授权策略名称之后搜索,选择对应的策略点击确认。
授权策略:
QcloudVCLMFullAccess

3. 调用 API 接口(示例)
因视频风格化接口是异步接口,需调用提交视频风格化任务跟查询视频风格化任务2个接口。
序号 | 接口 | 说明 |
1 | 提交视频风格化任务 | 输入风格与视频 URL 之后提交请求,请求成功会返回一个 JobId 。 |
2 | 查询视频风格化任务 | 通过提交风格化任务返回的 JobId 去查询结果信息。 |
方式一:通过 API Explorer 在线调用接口
调用提交视频风格化任务接口:输入参数之后点击发起调用,会返回提交视频风格化任务的结果信息。
说明:
成功结果参考:请求成功会返回 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 进行调用,如下图:
