视频质检消息回调--企业直播-火山引擎

文档中心

企业直播

回调

视频质检消息回调

作用

在视频质检任务的整个生命周期内，当发生以下任一事件时，视频质检服务会向您设置的回调地址发送通知：

视频质检任务的状态发生变化，包括：待机审、机审中、待人审、已完成、任务执行失败
触发机审违规消息
提交是否人审通过消息

前提条件

已调用 CreateVideoTask 接口通过请求参数 CallbackURL 配置回调地址，或者将接收回调通知的接口地址提供给视频质检技术支持。

详情

在视频质检任务的整个生命周期内，当发生以下任一事件时，视频质检会将任务状态消息、机审违规消息，以及人审意见消息以 POST 方式提交至您配置的回调地址。

质检任务状态变化，包括待机审、机审中、待人审、已完成、任务执行失败
触发机审违规消息
提交人审是否通过消息

视频质检提交的消息不同，请求示例也有所不同。

任务状态消息，即 MessageType 取值为 1 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "TaskId": 123456,
    "TaskName": "video-task-demo",
    "TaskStartTime": 1736323200,
    "AccountId": 10001,
    "ProjectName": "186346****92009",
    "ProjectDisplayName": "Demo 项目",
    "RequestUuid": "InspectionVideoMessageCallback-987654",
    "EventType": "InspectionVideoMessageCallback",
    "Timestamp": 1736323260,
    "Sign": "md5-sign",
    "TaskType": 1,
    "Extra": "{\"biz_id\":\"abc\"}",
    "InspectionMessage": {
        "MessageType": 1,
        "TaskMessageDetail": {
            "SendTime": 1736323260,
            "Status": 2,
            "TaskStatus": 3
        }
    }
}

机审违规消息，即 MessageType 取值为 2 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "AccountId": 200***072,
    "EventType": "InspectionVideoMessageCallback",
    "Extra": "",
    "InspectionMessage": {
        "MachineMessageDetail": {
            "CustomSensitiveResult": {
                "SensitiveWord": "ASR",
                "StartTime": 510,
                "Text": "视频质检 ASR mock 文本"
            },
            "MessageId": 48668928,
            "RuleId": 222656,
            "RuleType": 2,
            "SendTime": 1780991854
        },
        "MessageType": 2
    },
    "ProjectDisplayName": "test",
    "ProjectName": "18634*****2009",
    "RequestUuid": "InspectionVideoMessageCallback-1867505474936835",
    "Sign": "d02b2cfa2856c1d*******bbfe9411",
    "Tags": [],
    "TaskId": 20132,
    "TaskName": "任务3",
    "TaskStartTime": 1780991765,
    "TaskType": 1,
    "Timestamp": 1780992382
}

人审是否通过消息，即 MessageType 取值为 4 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "TaskId": 123456,
    "TaskName": "video-task-demo",
    "TaskType": 1,
    "TaskStartTime": 1736323200,
    "AccountId": 10001,
    "ProjectName": "186346****92009",
    "ProjectDisplayName": "Demo 项目",
    "RequestUuid": "InspectionVideoMessageCallback-987656",
    "EventType": "InspectionVideoMessageCallback",
    "Timestamp": 1736323860,
    "Sign": "d02b2cfa2856c1d*******bbfe9411",
    "Extra": "{\"biz_id\":\"abc\"}",
    "InspectionMessage": {
        "MessageType": 4,
        "ManualResultDetail": {
            "MessageId": 17037,
            "ManualComment": "人工审核不通过",
            "UserId": 100001,
            "SendTime": 1736323860,
            "AuditStatus": "REJECTED"
        }
    }
}

超时重试

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数

参数	类型	说明
RequestUuid	String	请求回调的唯一标识。
TaskId	Long	视频质检任务 ID。
TaskName	String	视频质检任务名称。
TaskType	Integer	任务类型。固定取值为 `1`，表示对视频进行质检。
TaskStartTime	Long	视频质检任务开始时间。Unix 时间戳，单位为秒。
ProjectName	String	视频质检任务所属的项目 ID，项目的唯一标识。
ProjectDisplayName	String	视频质检任务所属的项目的展示名称。
AccountId	Long	账号 ID。
EventType	String	回调通知的事件类型，固定取值为 `InspectionVideoMessageCallback`。
Timestamp	Long	发送回调请求的时间。Unix 时间戳，单位为秒。该时间戳的具体含义根据触发事件的类型而有所不同：任务状态变更：当回调由任务状态变更（包括：待机审、机审中、待人审、已完成、任务执行失败）触发时，该字段表示状态实际发生变化的时间。机审违规消息：当回调由机审违规消息触发时，该字段表示发送该消息的时间。人审是否通过消息：当回调由提交是否人工审核通过消息触发时，该字段表示提交该结论的时间。
Sign	String	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountId`、`EventType`、`Timestamp` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。说明请联系技术支持获取鉴权 `AccountSecret`。
Extra	String	CreateTask 接口传入的业务相关信息。
InspectionMessage	Object of InspectionMessage	视频质检消息详情。

InspectionMessage

参数	类型	说明
MessageType	Integer	消息类型。取值如下： `1`：任务状态消息 `2`：机审违规消息 `4`：质检报告生成后，人审是否通过消息
TaskMessageDetail	Object of TaskMessageDetail	任务状态消息详情。说明仅当 `MessageType` 取值为 `1` 时，返回该参数。
MachineMessageDetail	Object of MachineMessageDetail	机审违规消息详情。说明仅当 `MessageType` 取值为 `2` 时，返回该参数。
ManualResultDetail	Object of ManualResultDetail	人审是否通过详情。说明仅当 `MessageType` 取值为 `4` 时，返回该参数。

TaskMessageDetail

参数	类型	说明
SendTime	Long	任务状态消息触发时间，即任务状态（包括：待机审、机审中、待人审、已完成、任务执行失败）变更时间。Unix 时间戳，单位为秒。
TaskStatus	Integer	任务状态。取值如下： `1`：待机审（当质检任务暂未启动时，返回该值） `2`：机审中 `3`：待人审 `4`：已完成（人审已完成） `5`：任务执行失败
Status（已废弃）	Integer	任务状态。取值如下： `1`：开始，即机审中状态（质检任务创建成功后，即进入机审中状态） `2`：成功，即待人审状态 `3`：任务执行失败注意该参数已废弃。请参考 `TaskStatus` 参数。

参数

类型

说明

SendTime

Long

任务状态消息触发时间，即任务状态（包括：待机审、机审中、待人审、已完成、任务执行失败）变更时间。Unix 时间戳，单位为秒。

TaskStatus

Integer

任务状态。取值如下：

1：待机审（当质检任务暂未启动时，返回该值）
2：机审中
3：待人审
4：已完成（人审已完成）
5：任务执行失败

Status（已废弃）

Integer

任务状态。取值如下：

1：开始，即机审中状态（质检任务创建成功后，即进入机审中状态）
2：成功，即待人审状态
3：任务执行失败

注意

该参数已废弃。请参考 TaskStatus 参数。

MachineMessageDetail

参数	类型	说明
RuleId	Long	规则 ID。
RuleType	Integer	规则类型。取值如下： `1`：系统敏感词 `2`：自定义敏感词 `3`：OCR 文本，即检测视频画面中的文字 `4`：滚动字幕，即检测内嵌在视频流画面中的滚动文字 `5`：豆包文字分析，即用豆包大模型检测视频语言识别的文本 `6`：豆包图像分析，即用豆包大模型检测视频画面
MessageId	Long	机审消息 ID。
SendTime	Long	机审消息触发时间，即机审触发指定规则，判定机审不通过的时间。Unix 时间戳，单位为秒。
SystemSensitiveResult	Object of SystemSensitiveResult	系统敏感词的检测结果。说明仅当`RuleType` 取值为 `1` 时，返回该参数。
CustomSensitiveResult	Object of CustomSensitiveResult	自定义敏感词的检测结果。说明仅当`RuleType` 取值为 `2` 时，返回该参数。
OCRTextRecognitionResult	Object of OCRTextRecognitionResult	OCR 文本的检测结果。说明仅当`RuleType` 取值为 `3` 时，返回该参数。
OCRBottomSubtitleResult	Object of OCRBottomSubtitleResult	滚动字幕的检测结果。说明仅当`RuleType` 取值为 `4` 时，返回该参数。
LLMTextResult	Object of LLMTextResult	用豆包大模型检测视频语言识别文本的结果。说明仅当`RuleType` 取值为 `5` 时，返回该参数。
LLMImageResult	Object of LLMImageResult	用豆包大模型检测视频画面的结果。说明仅当`RuleType` 取值为 `6` 时，返回该参数。

CustomSensitiveResult

参数	类型	说明
SensitiveWord	String	命中的自定义敏感词。
Text	String	包含自定义敏感词的语音识别文本内容。
StartTime	Long	触发语音识别文本的时间点，表示从视频开始到触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。

SystemSensitiveResult

参数	类型	说明
Text	String	包含系统敏感词的语音识别文本内容。
StartTime	Long	触发语音识别文本的时间点，表示从视频开始到触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。

OCRTextRecognitionResult

参数	类型	说明
ImageURL	String	违规的 OCR 文本截图链接，包含协议头。有效期为 3 天，请尽快下载保存。
StartTime	Long	违规的 OCR 文本相对于视频开始时间的出现时间。单位为秒。例如视频于 10:00:00 开始，OCR 文本出现在 10:01:00，则参数取值为 `60`。

OCRBottomSubtitleResult

参数	类型	说明
ImageURLs	[]String	违规的滚动字幕截图链接，包含协议头。有效期为 24 小时，请尽快下载保存。
StartTime	Long	违规的滚动字幕开始出现的时间。单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。
EndTime	Long	OCR 滚动字幕规则结束触发的时间点，表示从视频开始到结束触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 结束，则参数值为 `90`。

LLMTextResult

参数	类型	说明
Text	String	用豆包大模型检测出的违规的 ASR 文字。
StartTime	Long	文本内容在视频中出现的时间点，表示从视频开始到该文本出现的时间间隔，单位为秒。例如视频从 00:00 开始播放，某文本在 01:30 出现，则参数值为 `90`。
EndTime	Long	文本内容在视频中消失的时间点，表示从视频开始到该文本消失的时间间隔，单位为秒。例如视频从 00:00 开始播放，某文本在 01:30 消失，则参数值为 `90`。
Description	String	违规原因。

LLMImageResult

参数	类型	说明
ImageURL	String	用豆包大模型检测出的违规的图像链接，包含协议头。有效期为 3 天，请尽快下载保存。
StartTime	Long	图像在视频中出现的时间点，表示从视频开始到该图像出现的时间间隔，单位为秒。例如视频从 00:00 开始播放，某图像在 01:30 出现，则参数值为 `90`。
Description	String	违规原因。

ManualResultDetail

参数	类型	说明
MessageId	Long	人审消息 ID。
ManualComment	String	人审是否通过或不通过结论的备注。
UserId	Long	审核人用户 ID。取值为 `0` 表示主账号。
SendTime	Long	人审结论消息触发时间，即提交人审结论的时间。Unix 时间戳，单位为秒。
AuditStatus	String	对当前任务中的视频内容给出是否审核通过的结论。取值如下： `APPROVED`：审核通过 `REJECTED`：审核不通过

最近更新时间：2026.06.11 11:04:31

这个页面对您有帮助吗？

有用

无用

企业直播

作用 #

前提条件 #

详情 #

超时重试 #

参数 #

InspectionMessage #

TaskMessageDetail #

MachineMessageDetail #

CustomSensitiveResult #

SystemSensitiveResult #

OCRTextRecognitionResult #

OCRBottomSubtitleResult #

LLMTextResult #

LLMImageResult #

ManualResultDetail #

作用