Only the Chinese version of this page is provided currently. The English version will be provided soon.
Help & Documentation>内容安全平台>API 文档>审核 Agent>视频审核 Agent

视频审核 Agent

Last updated: 2026-10-30 10:24:00

On this page:

1. 接口概述

请求域名：vm.tencentcloudapi.com
本服务主输入为视频，可同时输入图片、文本作为辅助判断信息：
视频要求：一次请求最多支持 1 个视频
图片要求：一次请求最多支持 5 张图片
文本要求：一次请求最多支持 5000 字
本接口为异步调用模式，单次审核耗时在分钟级：
默认并发：10，若需要增加并发路数，需要确保资源利用率，不支持脉冲式调用
队列处理机制：先进先出，即并发任务达到上限时，新任务进入队列等待处理；支持 Priority 字段设置任务优先级，数值越大优先级越高

2. 接口参数

任务创建接口 CreateVideoModerationTask

输入参数

参数名称
必选
类型
描述
Action
是
String
公共参数，本接口取值：CreateVideoModerationTask。
Version
是
String
公共参数，本接口取值：2020-12-29。
Region
是
String
公共参数，本接口取值：ap-guangzhou。
CallbackUrl
是
String
接收审核信息回调地址，审核结果将发送至此地址。
示例值：https://examplexxxxxxxx.com
BizType
是
String
该字段唯一标识审核策略，获取方式请联系商务或架构师。
示例值：tianyu_ad_quality_audit_xxxx
Tasks
是
Array of TaskInput
待检测的视频，一次请求只能输入1个视频（详见下方 TaskInput 参数说明）
Priority
否
Integer
任务优先级，若未传值系统默认为 0，数值越大优先级越高。
Type
是
String
固定取值：VIDEO_LLM
TaskInput（被上述 CreateVideoModerationTask 引用）
参数名称
必选
类型
描述
DataId
否
String
该字段是您为待检测视频自定义的 ID，作用是便于您对视频进行标识和管理。
取值：支持英文字母、数字、四种特殊符号（_，-，@，#），长度不超过64个字符。
示例值：a6127dd-c2a0-43e7-a3da-d27022d39ba7
Name
否
String
该字段逻辑同 DataId，为自定义透传字段。
示例值：kaipingguanggao_260525102500
Input
是
StorageInfo
待审核的视频的资源信息（详见下方 StorageInfo 参数说明）
说明：
DataId 和 Name 为可选字段，若您需要将审核视频与自身系统进行 ID 或名称关联，可传入这两个字段（天御侧不对这两个字段做逻辑处理）
StorageInfo（被上述 TaskInput 引用）：
参数名称
必选
类型
描述
Type
是
String
本接口固定取值：URL
Url
否
String
待审核的视频资源链接
示例值：https://xxxxxx-001.cos.ap-guangzhou.myqcloud.com/xxx_audio.mp4
ImageUrlList
否
Array of String
待审核的图片资源链接，最多支持传入5张图片
示例值：['https://xxxxxxxxx1.jpg', 'https://xxxxxxxxx2.jpg']
TextContent
否
String
待审核的文本内容，需为 UTF-8编码并以 Base64格式传入，字数限制5000字内
Title
否
String
待审核的标题内容，字数限制1000字内
Extra
否
String
额外信息
说明：
Image、Text、Title 通常作为上下文关联信息进行联合审核，您可根据实际业务诉求选填。

输出参数

参数名称
类型
描述
RequestId
String
唯一请求 ID，由服务端生成，每次请求都会返回，定位问题时需要使用该字段的值。
说明：若请求因其它原因未能抵达腾讯云天御的服务端，则该次请求不会获得 RequestId。
Results
Array of TaskResult
任务创建结果（详见下方 TaskResult 参数说明）
TaskResult（被上述 Results 参数引用）
参数名称
类型
描述
DataId
String
透传入参字段 DataId 的值
TaskId
String
天御侧系统返回的任务 ID，用于后续查询任务审核状态及结果
示例值：w-video-aqwfdNiA4vq3Zysfa1
Code
String
错误码。若任务创建成功返回 OK，其它值请参见 公共错误码
Message
String
对应 Code 的详情字段

结果查询接口 DescribeTaskDetail

输入参数

参数名称
必选
类型
描述
Action
是
String
本接口固定取值：DescribeTaskDetail。
Version
是
String
本接口固定取值：2021-09-22。
Region
是
String
本接口固定取值：ap-guangzhou
TaskId
是
String
天御侧系统返回的任务 ID，取值来源于创建任务返回的 Results 字段
示例值：w-video-aqwfdNiA4vq3Zysfa1
ShowAllSegments
否
Boolean
该字段用于设置结果查询的返回范围：
false：仅获取命中审核规则的分片，即审核结果为 block 或 review 的分片
true：获取全部分片结果，即审核结果为 pass 的分片也一并返回
说明：单次查询最多返回 720 条分片结果，默认值为 false

输出参数

参数名称
类型
描述
TaskId
String
任务 ID，对应创建任务返回的 Results 字段里的 TaskId
DataId
String
对应 CreateVideoModerationTask 接口中传入的 DataId
Name
String
对应 CreateVideoModerationTask 接口中传入的 Name
BizType
String
对应 CreateVideoModerationTask 接口中传入的 BizType
Status
String
该字段返回查询任务的运行状态。
枚举值：FINISH（已完成）、PENDING （等待中）、RUNNING （进行中）、ERROR （出错）、CANCELLED （已取消）。
Suggestion
String
处置建议，枚举取值：Block、Review、Pass，判定规则如下：
Block（建议按违规处置）：原子能力中有一个返回 Block，则该字段为 Block。
Review（建议人工复审）：原子能力中无 Block 返回，但有 Review，则该字段为 Review。
Pass（未识别到违规项）：所有原子能力返回 Pass，则该字段为 Pass。
Labels
Array of TaskLabel
该字段用于返回检测结果所对应的标签（详见下方 TaskLabels 参数说明）
VideoSegments
Array of VideoSegments
该字段用于返回大模型审核的结果（详见下方 VideoSegments 参数说明）
RequestId
String
对应 CreateVideoModerationTask 接口中返回的 RequestId
Type
String
对应 CreateVideoModerationTask 接口中传入的 Type
TaskLabel（被上方 Labels 字段引用）
参数名称
类型
描述
Label
String
该字段用于返回检测结果所对应的标签。
Suggestion
String
处置建议，枚举取值：Block、Review、Pass。
VideoSegment 视频分片段落信息-每段最长3分钟（被上方 VideoSegments 字段引用）
参数名称
类型
描述
OffsetTime
String
截帧时间。
点播文件：该值为相对于视频偏移时间，单位为秒，例如：0，5，10
Result
VideoResult
视频分片段落的明细审核结果（详见下方 VideoResult 参数说明）
CreatedAt
String
视频分片段落审核完成时间
VideoResult（被上方 VideoSegments 字段引用）
参数名称
类型
描述
HitFlag
Integer
标识是否命中审核规则。
取值：0（未命中 - Suggestion 返回 Pass）、1（命中 - Suggestion 返回 Block 或 Review）。
Suggestion
String
处置建议，枚举取值：Block、Review、Pass
Detail
ObjectArray
本次任务执行的所有审核原子能力的结果，以数组的形式输出。单个原子能力的结构如下：
参数
类型
必有
参数描述
LabelName
String
是
审核原子能力名称
Reason
String
否
模型的判断原因，无则可不输出
TargetText
StringArray
否
命中的文本片段列表，无则可不输出
Suggestion
String
否
处置建议，枚举取值：Block、Review、Pass
Extra
Object
否
扩展业务字段，基于客户要求配置。例如：
{
"ClusterID":"IT1",
"Dimension":"ZT-5",
"SubSignalID":"IT1.2",
"Level":"L5"
}
Text
String
该字段用于返回音频文件经 ASR 识别后的文本信息
VideoUrl
String
该字段用于返回审核结果的视频访问链接（URL）
AudioUrl
String
该字段用于返回审核结果的音频访问链接（URL）
Duration
String
该字段用于返回视频切片的时长，单位为毫秒
RequestId
String
对应 CreateVideoModerationTask 接口中返回的 RequestId

3. 调用示例

任务创建接口 CreateVideoModerationTask

输入示例

POST / HTTP/1.1
Host: ims.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateVideoModerationTask
<公共请求参数>
{
    "CallbackUrl": "https://examplexxxxxxx.com",
    "BizType": "tianyu_ad_quality_audit_xxxx",
    "Tasks": [
        {
            "DataId": "a6127dd-c2a0-43e7-a3da-d27022d39ba7",
            "Name": "kaipingguanggao_260525102500",
            "Input": {
                "Type": "URL",
                "Url": "https://xxxxxx-001.cos.ap-guangzhou.myqcloud.com/xxx_audio.mp4",
                "ImageUrlList": ["https://xxx.jpg","https://xxx.jpg"],
                "TextContent": "5L2g55qE5Lil6LCo6K6p5L2g5Y+R546w77yM5Lqn5ZOB57uP55CG5Y+r5YmR6Z2S",
                "Title": "ADTest"
            }
        }
    ],
    "Type": "VIDEO_LLM",
    "Priority": 100
}

输出示例

{
    "Response": {
        "Results": [
            {
                "DataId": "0a782332-c9db-4cf5-a66e-20d60b4ea469",
                "TaskId": "w-video-aqwfdNiA4vq3Zysfa1",
                "Code": "OK",
                "Message": "Success"
            }
        ],
        "RequestId": "c933aca1-90d2-4ab8-b045-f1b08069d76f"
    }
}

结果查询接口 DescribeTaskDetail

输入示例

POST / HTTP/1.1
Host: ims.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTaskDetail
<公共请求参数>
{
    "TaskId": "w-video-aqwfdNiA4vq3Zysfa1",
    "ShowAllSegments": "true"
}

输出示例

{
    "Response": {
        "TaskId": "w-video_llm-abKHr4AVIaEs5AyI",
        "DataId": "06541fdb-bcfd-4595-af25-80a554fd81be",
        "Status": "FINISH",
        "Suggestion": "Block", 
        "Labels": [ 
            {
                "Label": "质量度",
                "Suggestion": "Block"
            }
        ],
        "VideoSegments": [ 
            {
                "OffsetTime": "0",
                "Result": {
                    "HitFlag": 1, 
                    "Suggestion": "Block", 
                    "Detail": [
                        {
                            "LabelName": "相关性",
                            "Reason": "文案宣传短剧内容，图片展示短剧推广界面及APP下载引导，主题一致",
                            "TargetText": [],
                            "Suggestion": "Pass"
                        },
                        {
                            "LabelName": "美观度",
                            "Reason": "画面为油画风格，纹理明显，无模糊、锯齿或噪点问题",
                            "TargetText": [],
                            "Suggestion": "Pass"
                        },
                        {
                            "LabelName": "质量度",
                            "Reason": "画面为简陋草屋场景，叠加‘农妇村’等文字，属于非写真风格照片，不符合剧照标准。",
                            "TargetText": [],
                            "Suggestion": "Block"
                        }
                    ]
                },
                "CreatedAt": "2026-03-12T09:30:25Z"
            }
        ],
        "RequestId": "c922f0a9-b4fd-4275-94d6-0c342beab6d0"
    }
}

中国站 - English