1. 接口描述
接口请求域名: trtc.tencentcloudapi.com 。
接口说明:
启动云端审核功能,完成房间内的音视频切片,视频截帧,或者录制音频流,送审到指定的审核商,完成审核。
您可以通过此接口实现如下目标:
- 指定审核参数(ModerationParams)来指定审核需要的详细参数。
- 指定存储参数(ModerationStorageParams)将命中的审核文件指定上传到您希望的云存储,目前支持腾讯云(对象存储COS)和第三方AWS
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateCloudModeration。 |
Version | 是 | String | 公共参数,本接口取值:2019-07-22。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-shanghai 。 |
SdkAppId | 是 | Integer | TRTC的SdkAppId,和TRTC的房间所对应的SdkAppId相同。 示例值:1400188366 |
RoomId | 是 | String | TRTC的RoomId,为TRTC房间所对应的RoomId。 示例值:295212 |
UserId | 是 | String | 机器人的UserId,用于进房发起审核任务。【*注意】这个UserId不能与当前房间内的主播观众UserId重复。如果一个房间发起多个切片任务时,机器人的userid也不能相互重复,否则会中断前一个切片任务。建议可以把房间ID作为UserId的标识的一部分,即机器人UserId在房间内唯一。 示例值:robot_1234 |
UserSig | 是 | String | 机器人UserId对应的校验签名,即UserId和UserSig相当于机器人进房的登录密码,具体计算方法请参考TRTC计算UserSig的方案。 示例值:JwsjsHKgkAURt-lbv8fuXdyzAZauImIZBKDwJ3oKFdJhhkNI3r3yNxB853XnA954GZLTsDiqSUAhH-l5VrM4zcsHGggAdvTTXCD-m6L63lGhSFiBTHmyhaCbegwIZ-WXfsu2kotauoccklT-Up0fOueN78pH15KFyrZZrtVXI92-BNhSChKRV91jORYDw |
ModerationParams | 是 | ModerationParams | 云端审核控制参数。 |
ModerationStorageParams | 是 | ModerationStorageParams | 云端审核文件上传到云存储的参数 |
RoomIdType | 否 | Integer | TRTC房间号的类型。 【*注意】必须和录制的房间所对应的RoomId类型相同: 0: 字符串类型的RoomId 1: 32位整型的RoomId(默认) 示例值:1 示例值:1 |
ResourceExpiredHour | 否 | Integer | 任务ID可以调用的时效性,从成功开启任务并获得TaskID后开始计算,超时后无法调用查询、更新和停止等接口,但是切片任务不会停止。 参数的单位是小时,默认24小时(1天),最大可设置72小时(3天),最小设置6小时。举例说明:如果不设置该参数,那么开始切片成功后,查询、更新和停止切片的调用时效为24个小时。 示例值:24 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
TaskId | String | 云端审核服务分配的任务ID。任务ID是对一次切片任务生命周期过程的唯一标识,结束任务时会失去意义。任务ID需要业务保存下来,作为下次针对这个任务操作的参数 示例值:-npVqpdU7pr3JUbUasDy5PLPQaHPhkPbIkDILoK-2OqyoZWQndibCtH88ztBhkWAhZCH9DwE. |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 创建云端审核任务
启动SdkAppId 为 200806 指定房间(房间号为150)的云端审核任务。
房间空闲等待时间设置为30秒。
送审模式设置为,每隔5秒,送审一张视频截帧图片到ace审核商
音频每隔15秒,送审一个15s长的音频到ace审核
审核结果通过配置的回调url触达
输入示例
POST / HTTP/1.1
Host: trtc.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateCloudSliceTask
<公共请求参数>
{
"SdkAppId": 200806,
"RoomId": "150",
"RoomIdType": 1,
"UserId": "inspect",
"UserSig": "eJwszc3KgkAUxvF7Odv3xY6jx2KgRU1NPHMy3CnQIZEJBDxf1SulLZcs*pAAuveqIuFaeqrW2kMVyAFYogrTGbnBiScDmm2zf0*HdqoLAhxQ85dn4vMn4*N8zFT7f-aXIf3Zj0fWn78*ktBUUyJoEmHMS0ChM83AAD---1NMfA_",
"ModerationParams": {
"ModerationType": 1,
"MaxIdleTime": 30,
"SliceAudio": 15,
"SliceVideo": 5,
"ModerationSupplier": "ace",
"ModerationSupplierParam": {
"AppID": "2501",
"SecretId": "ace_ugc_20521",
"SecretKey": "637ae34f4069afb92xxxxxxx",
"AudioBizType": "2001",
"ImageBizType": "2002"
},
"SaveModerationFile": 0,
"CallbackAllResults": 0
},
"ModerationStorageParams": {
"CloudModerationStorage": {
"Vendor": 0,
"Region": "ap-guangzhou",
"Bucket": "av-recover-prod-1258344699",
"AccessKey": "AKIDiGYZYrugBPM3TbS2MO9dqmRp",
"SecretKey": "91w4wXswiDSQ7XfX8So31Bm6",
"FileNamePrefix": [
"testname"
]
}
},
"ResourceExpiredHour": 72
}
输出示例
{
"Response": {
"RequestId": "6c8eac0c-a46e-4002-893a-935160b43b34",
"TaskId": "-npVqpdU7qidKD61us+k9KlbamMCLrDbczWnLoK-2OqyoZWQndib8Ma8fbGq2JxnW26LgE."
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure | CAM签名/鉴权错误。 |
AuthFailure.UnRealNameAuthenticated | 未完成实名认证,不允许此操作。 |
AuthFailure.UnauthorizedOperation | CAM鉴权失败。 |
AuthFailure.UnsupportedOperation | 不支持该操作。 |
FailedOperation | 操作失败。 |
FailedOperation.CSUnsupportMethod | 云端切片方法不支持。 |
FailedOperation.RestrictedConcurrency | 单用户并发过载,请联系我们增大并发路数到合理值。 |
InternalError.CSInternalError | 云端切片内部服务错误 |
InvalidParameter.OutOfRange | 参数超出范围。 |
InvalidParameter.SdkAppId | SdkAppId参数错误。 |
MissingParameter.AccessKey | 缺少AccessKey参数。 |
MissingParameter.Bucket | 缺少Bucket参数。 |
MissingParameter.Region | 缺少Region参数。 |
MissingParameter.RoomId | 缺少RoomId参数。 |
MissingParameter.SdkAppId | 缺少SdkAppId参数。 |
MissingParameter.SecretKey | 缺少SecretKey参数。 |
MissingParameter.SliceParams | 缺少SliceParams参数。 |
MissingParameter.SliceStorageParams | 缺少SliceStorageParams参数。 |
MissingParameter.SliceType | 缺少SliceType参数。 |
MissingParameter.TaskId | 缺少TaskId参数。 |
MissingParameter.UserId | 缺少UserId参数。 |
MissingParameter.UserSig | 缺少UserSig参数。 |
MissingParameter.Vendor | 缺少Vendor参数。 |
UnsupportedOperation | 操作不支持。 |