创建云端审核

最近更新时间:2025-07-18 01:48:43

我的收藏

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。

命令行工具

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 操作不支持。