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

文档中心

立即注册

导航

质检消息回调

最近更新时间：2025.10.23 22:48:32首次发布时间：2025.04.15 20:51:42

作用

在任务开始到结束的整个生命周期中，当发生以下事件时，直播质检会对所设置的接口地址进行回调通知。

质检任务状态变化，包括任务开始、任务结束和任务执行失败
触发机审违规消息
提交人审处置意见

前提条件

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

详情

在任务开始到结束的整个生命周期中，当发生以下事件时，直播质检会将任务状态消息、机审违规消息，以及人审处置意见消息以 POST 方式提交至您配置的回调地址。

质检任务状态变化，包括任务开始、任务结束和任务执行失败
触发机审违规消息
提交人审处置意见

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

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

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
  "AccountId": 200***0872,
  "EventType": "InspectionMessageCallback",
  "Extra": "extra",
  "InspectionMessage": {
    "MessageType": 1,
    "TaskMessageDetail": {
      "SendTime": 1744558807,
      "TaskStatus": 3
    }
  },
  "RequestUuid": "InspectionMessageCallback-1829302****90874",
  "Sign": "f0415f9ae2530****0b9ae17bf476bf1",
  "TaskId": 2047,
  "TaskName": "任务 A",
  "TaskStartTime": 1751273231,
  "ActivityId": 1***9,
  "ActivityName": "直播间 A",
  "ProjectName": "17**231",
  "ProjectDisplayName": "项目 A",
  "Tags": [
    {
      "ParentTagId": 11,
      "ParentTagName": "标签 A",
      "TagId": 31,
      "TagName": "标签 B"
    }
  ],
  "Timestamp": 1744558807
}

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

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
  "AccountId": 200***0872,
  "EventType": "InspectionMessageCallback",
  "Extra": "extra",
  "InspectionMessage": {
    "MachineMessageDetail": {
      "MessageId": 182935****92411,
      "CustomSensitiveResult": {
        "SensitiveWord": "敏感词",
        "StartTime": 15,
        "Text": "自定义敏感词"
      },
      "RuleId": 243,
      "RuleType": 2,
      "SendTime": 1744609298
    },
    "MessageType": 2
  },
  "RequestUuid": "InspectionMessageCallback-1829355****92411",
  "Sign": "05dd8515841c438****ad0aef1b78464",
  "TaskId": 2746,
  "TaskName": "任务 A",
  "TaskStartTime": 1751273231,
  "ActivityId": 1***9,
  "ActivityName": "直播间 A",
  "ProjectName": "17**231",
  "ProjectDisplayName": "项目 A",
  "Tags": [
    {
      "ParentTagId": 11,
      "ParentTagName": "标签 A",
      "TagId": 31,
      "TagName": "标签 B"
    }
  ],
  "Timestamp": 1744609298
}

人审处置意见消息，即 MessageType 取值为 3 时，请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
  "AccountId": 200***0872,
  "EventType": "InspectionMessageCallback",
  "Extra": "extra",
  "InspectionMessage": {
    "ManualMessageDetail": {
      "MessageId": 182935****92411,
      "ManualComment": "直播警告",
      "SendTime": 1744609273,
      "UserId": 0,
      "OperationType": "WARNING"
    },
    "MessageType": 3
  },
  "RequestUuid": "InspectionMessageCallback-18293554****5332",
  "Sign": "3be07ada2084e8****942e77693f7e8c",
  "TaskId": 2746,
  "TaskName": "任务 A",
  "TaskStartTime": 1751273231,
  "ActivityId": 1***9,
  "ActivityName": "直播间 A",
  "ProjectName": "17**231",
  "ProjectDisplayName": "项目 A",
  "Tags": [
    {
      "ParentTagId": 11,
      "ParentTagName": "标签 A",
      "TagId": 31,
      "TagName": "标签 B"
    }
  ],
  "Timestamp": 1744609273
}

超时重试

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

参数

说明

请联系技术支持获取鉴权 AccountSecret。

参数	类型	说明
RequestUuid	String	请求回调的唯一标识。
TaskId	Long	质检任务 ID。
TaskName	String	质检任务名称。
TaskStartTime	Long	质检任务开始时间。Unix 时间戳，单位为秒。
ActivityId	Long	质检任务关联的企业直播直播间 ID。仅在满足以下任一条件时，返回该参数：创建质检任务时关联了直播间 ID 联系直播质检技术支持绑定企业直播账号后，主播通过企业直播开播，直播质检平台自动创建质检任务
ActivityName	String	质检任务关联的企业直播直播间名称。仅在满足以下任一条件时，返回该参数：创建质检任务时关联了直播间 ID 联系直播质检技术支持绑定企业直播账号后，主播通过企业直播开播，直播质检平台自动创建质检任务
ProjectName	String	质检任务所属的项目 ID，项目的唯一标识。
ProjectDisplayName	String	质检任务所属的项目的展示名称。
Tags	Array of Tag	质检任务标签。
AccountId	Long	账号 ID。
EventType	String	回调通知的事件类型，固定取值为 `InspectionMessageCallback`。
Timestamp	Long	发送回调请求的时间。Unix 时间戳，单位为秒。
Sign	String	校验签名。完成以下步骤，计算校验签名。按照 `AccountSecret`、`AccountId`、`EventType`、`Timestamp` 的顺序，拼接对应的参数值。将拼接后的内容进行 MD5 加密生成 32 位小写字符串。
Extra	String	CreateTask 接口传入的业务相关信息。
InspectionMessage	Object of InspectionMessage	质检消息详情。

Tag

参数	类型	说明
TagId	Long	标签 ID。
TagName	String	标签名称。
ParentTagId	Long	父标签 ID。
ParentTagName	String	父标签名称。

InspectionMessage

参数	类型	说明
MessageType	Integer	消息类型。取值如下： `1`：任务状态消息 `2`：机审违规消息 `3`：人审处置意见消息
TaskMessageDetail	Object of TaskMessageDetail	任务状态消息详情。说明仅当 `MessageType` 取值为 `1` 时，返回该参数。
MachineMessageDetail	Object of MachineMessageDetail	机审违规消息详情。说明仅当 `MessageType` 取值为 `2` 时，返回该参数。
ManualMessageDetail	Object of ManualMessageDetail	人审处置意见消息详情。说明仅当 `MessageType` 取值为 `3` 时，返回该参数。

TaskMessageDetail

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

参数

类型

说明

SendTime

Long

任务状态消息触发时间，即任务状态变更时间。Unix 时间戳，单位为秒。

TaskStatus

Integer

任务状态。取值如下：

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

Status（已废弃）

Integer

任务状态。取值如下：

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

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	语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始，语音识别文本出现在 10:01:00，则参数取值为 `60`。

SystemSensitiveResult

参数	类型	说明
Text	String	包含系统敏感词的语音识别文本内容。
StartTime	Long	语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始，语音识别文本出现在 10:01:00，则参数取值为 `60`。

OCRTextRecognitionResult

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

OCRBottomSubtitleResult

参数	类型	说明
ImageURLs	[]String	违规的滚动字幕截图链接，包含协议头。有效期为 3 天，请尽快下载保存。
StartTime	Long	相对于直播开始时间，违规的滚动字幕开始出现的时间。单位为秒。例如直播于 10:00:00 开始，违规的滚动字幕在 10:01:00 开始出现，则参数取值为 `60`。
EndTime	Long	相对于直播开始时间，违规的滚动字幕停止出现的时间。单位为秒。例如直播于 10:00:00 开始，违规的滚动字幕在 10:02:00 停止出现，则参数取值为 `120`。

LLMTextResult

参数	类型	说明
Text	String	用豆包大模型检测出的违规的 ASR 文字。
StartTime	Long	相对于直播开始时间，违规的 ASR 文字开始出现的时间。单位为秒。例如直播于 10:00:00 开始，违规的 ASR 文字在 10:01:00 开始出现，则参数取值为 `60`。
EndTime	Long	相对于直播开始时间，违规的 ASR 文字停止出现的时间。单位为秒。例如直播于 10:00:00 开始，违规的 ASR 文字在 10:02:00 停止出现，则参数取值为 `120`。
Description	String	违规原因。

LLMImageResult

参数	类型	说明
ImageURL	String	用豆包大模型检测出的违规的图像链接，包含协议头。有效期为 3 天，请尽快下载保存。
StartTime	Long	相对于直播开始时间，违规图像出现的时间。单位为秒。例如直播于 10:00:00 开始，违规的图像在 10:01:00 开始出现，则参数取值为 `60`。
Description	String	违规原因。

ManualMessageDetail

参数	类型	说明
MessageId	Long	人审消息 ID。
ManualComment	String	人审处置意见。
UserId	Long	审核人用户 ID。取值为 `0` 表示主账号。
SendTime	Long	人审处置意见消息触发时间，即提交人审处置意见的时间。Unix 时间戳，单位为秒。
OperationType	String	对直播流执行的操作。取值如下： `WARNING`：监控台审核人员发出警告，主播在开播端会收到警告提醒。 `INTERRUPTION`：监控台审核人员发起断流操作，直播流将被强制中断 2 分钟，期间直播中断且主播无法推流。2 分钟后，直播自动恢复，主播可正常推流。