You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
直播质检 API
GetReport - 获取直播质检任务报告
复制全文
下载 pdf
GetReport - 获取直播质检任务报告

调用 GetReport 接口,获取指定直播质检任务的质检报告,包含违规占比、话术分析占比、图像分析占比等。

注意事项

  • 请求频率:单用户请求频率限制为 10 次/秒
  • 前提条件
    • 确保当前账号已开通直播质检服务。若当前账号为子账号,请同时确保主账号已在直播质检平台为该子账号授权,详见为子账号授权。否则账号将提示“暂无使用权限,请联系客服人员申请开通”。
    • 当任务状态为待人审或人审已完成时,即满足以下任一条件时,可调用当前接口,获取指定任务的质检报告。

请求说明

  • 请求方式:GET
  • 请求地址:https://livesaas.volcengineapi.com/?Action=GetReport&Version=2024-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数

Query

参数类型是否必选示例值描述
ActionStringGetReport接口名称。当前 API 的名称为 GetReport
VersionString2024-08-01接口版本。当前 API 的版本为 2024-08-01
ProjectNameString182701****608457项目名称。您可通过调用 ListProjects 接口,获取项目名称。
TaskIdLong397**671任务 ID。您可通过调用 CreateTaskListTasks 获取 ID。

返回参数

参数类型示例值描述
TaskDetailObject of TaskDetail-任务详情。
TaskResultObject of TaskResult-任务结果。
RuleResultDetailsArray of RuleResultDetails-规则结果。

TaskDetail

参数类型示例值描述
ProjectNameString182701****608457项目名称。
TaskIdLong397**671任务 ID。
TaskNameString任务 A任务名称。
TaskTypeInteger2任务类型。固定取值为 2,表示对直播进行质检。
TaskTypeDescString审核任务 1任务类型描述。

Status

Integer

4

任务状态。取值如下:

  • 1:待机审
  • 2:机审中
  • 3:待人审
  • 4:已完成(人审已完成)
  • 5:任务执行失败
ScenarioIdLong1审核场景 ID。
LivePullURLStringhttps://www.example.com直播拉流地址。
CreatedTimeLong1744012851任务创建时间。Unix 时间戳,单位为秒。
UpdatedTimeLong1744012851任务更新时间(任务更新指任务状态变化等情况)。Unix 时间戳,单位为秒。
CallbackURLStringhttps://www.example.comCreateTask 接口传入的视频质检消息的回调地址。详见直播质检消息回调
ExtraStringextraCreateTask 接口传入的业务相关信息。

ActivityId

Long

1778*****4933

直播质检任务关联的企业直播直播间 ID。
仅在满足以下任一条件时,该参数为直播间 ID,否则取值为 0

  • 创建直播质检任务时关联了直播间 ID
  • 联系直播质检技术支持绑定企业直播账号后,主播通过企业直播开播,直播质检平台自动创建质检任务
TagsArray of Tags-直播质检任务绑定的标签。

ActivityName

String

直播间 A

直播质检任务关联的企业直播直播间名称。
仅在满足以下任一条件时,该参数为直播间名称,否则取值为空字符串。

  • 创建直播质检任务时关联了直播间 ID
  • 联系直播质检技术支持绑定企业直播账号后,主播通过企业直播开播,直播质检平台自动创建质检任务

TaskResult

参数类型示例值描述
MachineStartTimeLong1744016864机审开始时间。Unix 时间戳,单位为秒。
MachineEndTimeLong1744016900机审完成时间。Unix 时间戳,单位为秒。
CostInteger36机审耗时,单位为秒。

ManualEndTime

Long

1744026900

最近一次人审完成时间。Unix 时间戳,单位为秒。
参数取值为 0,表示未进行人审。

RecordURLStringhttps://www.example.comM3U8 格式的视频回放地址,包含 HTTPS 协议头。有效期为 7 天,请尽快下载保存。
ASRResultObject of ASRResult-语音识别结果。

StatisticalData

Object of StatisticalData

-

统计数据。

说明

如需获取该数据,请联系直播质检技术支持。

ManualDetailsArray of ManualDetails-人审记录。

FinalManualStatus

Integer

2

人审状态。取值如下:

  • 0:未进行人审,即无人审记录
  • 1:人审通过
  • 2:人审不通过

RuleResultDetails

参数类型示例值描述
RuleNameString敏感词规则名称。

FinalManualStatus

Integer

2

人审状态。取值如下:

  • 0:未进行人审,即无人审记录
  • 1:人审通过
  • 2:人审不通过
ManualDetailsArray of ManualDetails-人审记录。

FinalMachineStatus

Integer

2

机审状态。取值如下:

  • 0:未进行机审
  • 1:机审通过
  • 2:机审不通过
MachineDetailsObject of MachineDetails-机审记录。
RuleIdLong101规则 ID。

RuleType

Integer

2

规则类型。取值如下:

  • 1:系统敏感词
  • 2:自定义敏感词
  • 3:豆包文字分析,即用豆包大模型检测直播语音识别的文本
  • 4:豆包图像分析,即用豆包大模型检测直播画面

ViolationType

Integer

1

规则策略。取值如下:

  • 0:分析。机审触发本规则,将仅在质检报告中显示机审分析结果
  • 1:违规。机审触发本规则,将判定为机审不通过,并在监控台进行机审提示

Tags

参数类型示例值描述
TagIdLong121标签 ID。
TagNameString标签 B标签名称。
ParentTagIdLong26父标签 ID。
ParentTagNameString标签 A父标签名称。

ASRResult

参数类型示例值描述
TextString分句 1,分句 2。完整语音识别文字内容。
UtterancesArray of Utterances-语音识别分句详情。

StatisticalData

参数类型示例值描述
ViolationListArray of ViolationList-违规占比列表。
ImageLLMAnalysisListArray of ImageLLMAnalysisList-图像分析占比列表。
TextLLMAnalysisListArray of TextLLMAnalysisList-话术分析占比列表。

ManualDetails

参数类型示例值描述

MessageId

Long

182935****92411

人审审核消息 ID。全局唯一。

说明

MessageId 返回值为 0,表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务,再调用本接口获取该字段的值。

ManualCommentString存在违规内容人审审核意见。
AuditorString主账号审核人。

UserId

Long

0

审核人用户 ID。
取值为 0表示主账号。

ManualSource

Integer

1

人审意见的来源。取值如下:

  • 1:监控台实时处理,或通过 SubmitAudit 接口的 OperationType 参数实时处理
  • 2:监控台规则审核
  • 3:质检报告任务审核,或通过 SubmitAudit 接口的 AuditStatus 参数提交人审意见
  • 4:质检报告规则审核
CreatedTimeLong1744016900人审记录创建时间。Unix 时间戳,单位为秒。

ManualStatus

Integer

2

人审状态。取值如下:

  • 0:未进行人审,即无人审记录
  • 1:人审通过
  • 2:人审不通过

MachineDetails

参数类型示例值描述

MachineType

Integer

2

机审规则类别。取值如下:

  • 1:系统敏感词
  • 2:自定义敏感词
  • 3:豆包文字分析,即用豆包大模型检测直播语音识别的文本
  • 4:豆包图像分析,即用豆包大模型检测直播画面
  • 5:OCR 文字识别
  • 6:OCR 滚动字幕

AnalysisTexts

Array of AnalysisTexts

-

文字的检测结果。

说明

仅当 MachineType 取值为 3 时,返回该参数。

AnalysisImages

Array of AnalysisImages

-

图像的检测结果。

说明

仅当 MachineType 取值为 4 时,返回该参数。

CustomSensitiveResults

Array of CustomSensitiveResults

-

自定义敏感词的检测结果。

说明

仅当 MachineType 取值为 2 时,返回该参数。

SystemSensitiveResults

Array of SystemSensitiveResults

-

系统敏感词的检测结果。

说明

仅当 MachineType 取值为 1 时,返回该参数。

OCRBottomSubtitleResults

Array of OCRBottomSubtitleResults

-

OCR 滚动字幕的检测结果。

说明

仅当 MachineType 取值为 6 时,返回该参数。

OCRTextRecognitionResults

Array of OCRTextRecognitionResults

-

OCR 文字识别的检测结果。

说明

仅当 MachineType 取值为 5 时,返回该参数。

Utterances

参数类型示例值描述
StartTimeLong60当前分句相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始,当前分句出现在 10:01:00,则参数取值为 60
EndTimeLong70当前分句相对于直播开始时间的消失时间。单位为秒。例如直播于 10:00:00 开始,当前分句出现在 10:01:00,消失在 10:01:10,则参数取值为 70
TextString分句 1分句文字。

ViolationList

参数类型示例值描述
TitleString分类 A分类名称。
CountInteger10分类数量。

ImageLLMAnalysisList

参数类型示例值描述
TitleString分类 B分类名称。
CountInteger10分类数量。

TextLLMAnalysisList

参数类型示例值描述
TitleString分类 C分类名称。
CountInteger10分类数量。

AnalysisTexts

参数类型示例值描述

MessageId

Long

182935****92412

文字分析的质检消息 ID。全局唯一。

说明

MessageId 返回值为 0,表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务,再调用本接口获取该字段的值。

TextString文本内容文字分析的文本内容。
TypeString分类 A文字分析的所属分类。已废弃。
AbsoluteStartTimeLong1744016864文本内容出现的时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016870文本内容消失的时间。Unix 时间戳,单位为秒。
DescriptionString涉及营销广告违规原因。
EndTimeLong70文本内容相对于直播开始时间的消失时间,单位为秒。
StartTimeLong60文本内容相对于直播开始时间的出现时间,单位为秒。

AnalysisImages

参数类型示例值描述

MessageId

Long

182935****92413

图像分析的质检消息 ID。全局唯一。

说明

MessageId 返回值为 0,表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务,再调用本接口获取该字段的值。

ImageURLsArray of String["https://www.example.com/a.png","https://www.example.com/b.png"]若画面触发了当前图像分析的规则,则会返回关键画面截图的 URL。链接有效期为 24 小时,请尽快下载保存。
TypeString分类 A图像的所属分类。已废弃。
AbsoluteStartTimeLong1744016864图像出现的时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016894图像结束的时间。Unix 时间戳,单位为秒。
DescriptionString出现非品牌物料违规原因。
EndTimeLong90图像相对于直播开始时间的消失时间,单位为秒。
StartTimeLong60图像相对于直播开始时间的出现时间,单位为秒。

CustomSensitiveResults

参数类型示例值描述

MessageId

Long

182935****92415

自定义敏感词检测的质检消息 ID。全局唯一。

说明

MessageId 返回值为 0,表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务,再调用本接口获取该字段的值。

SensitiveWordString敏感词命中的敏感词。
TextString文本内容包含敏感词的语音识别文本内容。
AbsoluteStartTimeLong1744016865语音识别文本的出现时间。Unix 时间戳,单位为秒。
StartTimeInteger60语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始,语音识别文本出现在 10:01:00,则参数取值为 60

SystemSensitiveResults

参数类型示例值描述

MessageId

Long

182935****92413

系统敏感词检测的质检消息 ID。全局唯一。

说明

MessageId 返回值为 0,表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务,再调用本接口获取该字段的值。

TextString文本内容包含敏感词的语音识别文本内容。
AbsoluteStartTimeLong1744016865语音识别文本的出现时间。Unix 时间戳,单位为秒。
StartTimeInteger60语音识别文本相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始,语音识别文本出现在 10:01:00,则参数取值为 60

OCRBottomSubtitleResults

参数类型示例值描述
MessageIdLong182935****92416OCR 滚动字幕的质检消息 ID。全局唯一。
ImageURLsArray of String["https://www.example.com/a.png","https://www.example.com/b.png"]若在 OCR 滚动字幕规则检测过程中,字幕出现了您指定的预设文字,则会返回关键画面截图的 URL。链接有效期为 24 小时,请尽快下载保存。
StartTimeLong60OCR 字幕相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始,OCR 滚动字幕出现在 10:01:00,则参数取值为 60
EndTimeLong70OCR 字幕相对于直播开始时间的消失时间。单位为秒。例如直播于 10:00:00 开始, OCR 滚动字幕消失在 10:01:00,则参数取值为 60
AbsoluteStartTimeLong1744016864OCR 滚动字幕的出现时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016874OCR 滚动字幕的消失时间。Unix 时间戳,单位为秒。
DescriptionString检测到违规滚动字幕违规原因。
TypeString分类 AOCR 结果所属分类。已废弃。

OCRTextRecognitionResults

参数类型示例值描述
MessageIdLong182935****92416OCR 文字识别的质检消息 ID。全局唯一。
ImageURLsArray of String["https://www.example.com/a.png","https://www.example.com/b.png"]若在 OCR 文字识别规则检测过程中,画面出现了您指定的预设文字,则会返回关键画面截图的 URL。链接有效期为 24 小时,请尽快下载保存。
StartTimeLong60OCR 文字相对于直播开始时间的出现时间。单位为秒。例如直播于 10:00:00 开始,OCR 文字出现在 10:01:00,则参数取值为 60
EndTimeLong70OCR 文字相对于直播开始时间的消失时间。单位为秒。例如直播于 10:00:00 开始, OCR 文字消失在 10:01:00,则参数取值为 60
AbsoluteStartTimeLong1744016864OCR 文字的出现时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016874OCR 文字的消失时间。Unix 时间戳,单位为秒。
DescriptionString检测到违规话术违规原因。
TypeString分类 AOCR 结果所属分类。已废弃。

请求示例

GET https://livesaas.volcengineapi.com/?Action=GetReport&Version=2024-08-01&ProjectName=182701****608457&TaskId=397**671

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GetReport",
    "Version": "2024-08-01",
    "Service": "livesaas",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskDetail": {
      "TaskId": 397**671,
      "TaskName": "任务A",
      "ProjectName": "182701****608457",
      "TaskType": 2,
      "TaskTypeDesc": "审核任务1",
      "Status": 4,
      "ScenarioId": 1,
      "CreatedTime": 1744012851,
      "UpdatedTime": 1744012851,
      "CallbackURL": "https://www.example.com",
      "Extra": "extra",
      "LivePullURL": "https://www.example.com",
      "ActivityId": 1778123412343,
      "ActivityName": "直播间A",
      "Tags": [
        {
          "TagId": 121,
          "TagName": "标签B",
          "ParentTagId": 26,
          "ParentTagName": "标签A"
        }
      ]
    },
    "TaskResult": {
      "MachineStartTime": 1744016864,
      "MachineEndTime": 1744016900,
      "Cost": 36,
      "ManualEndTime": 1744026900,
      "ASRResult": {
        "Text": "分句1,分句2。",
        "Utterances": [
          {
            "StartTime": 60,
            "EndTime": 70,
            "Text": "分句1"
          }
        ]
      },
      "RecordURL": "https://www.example.com",
      "StatisticalData": {
        "ViolationList": [
          {
            "Title": "分类A",
            "Count": 10
          }
        ],
        "ImageLLMAnalysisList": [
          {
            "Title": "分类B",
            "Count": 10
          }
        ],
        "TextLLMAnalysisList": [
          {
            "Title": "分类C",
            "Count": 10
          }
        ]
      },
      "ManualDetails": [
        {
          "MessageId": 182935****92414,
          "ManualComment": "存在违规内容",
          "Auditor": "主账号",
          "UserId": 0,
          "ManualSource": 1,
          "CreatedTime": 1744016900,
          "ManualStatus": 2
        }
      ],
      "FinalManualStatus": 2
    },
    "RuleResultDetails": [
      {
        "RuleName": "敏感词",
        "FinalManualStatus": 2,
        "ManualDetails": [
          {
            "MessageId": 182935****92413,
            "ManualComment": "审核不通过。",
            "Auditor": "主账户",
            "UserId": 0,
            "ManualSource": 1,
            "CreatedTime": 1744016900,
            "ManualStatus": 2
          }
        ],
        "FinalMachineStatus": 2,
        "MachineDetails": {
          "MachineType": 2,
          "CustomSensitiveResults": [
            {
              "MessageId": 182935****92412,
              "Text": "文本内容",
              "AbsoluteStartTime": 1744016865,
              "StartTime": 60,
              "SensitiveWord": "敏感词"
            }
          ]
        },
        "RuleId": 101,
        "RuleType": 2,
        "ViolationType": 1
      }
    ]
  }
}

错误码

下表提供了该接口特有的错误码,公共错误码请参见公共错误码错误码文档。

状态码错误码错误信息说明

400

ReportNotFoundError

report not found

直播质检任务未执行完毕或执行失败,导致未生成质检报告。

  • 如果任务未执行完毕,请等待任务执行完毕后,再重新调用该接口。
  • 如果任务执行失败,请重新调用 CreateTask 接口,确保配置的直播拉流地址(LivePullURL)有效,以及任务未超出并发数上限,再重新调用 GetReport接口获取质检报告。
最近更新时间:2026.06.22 21:14:23
这个页面对您有帮助吗?
有用
有用
无用
无用