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
AuditIDLong1敏感词记录对应的审核 ID。

MuteExecutionStatus

String

PENDING

消音执行状态。取值如下:

  • PENDING:消音等待执行中
  • FULL_HIT:要消音的敏感词已全部执行
  • PARTIAL_HIT:要消音的敏感词已部分执行。例如:若敏感词为"违规消音",最终仅“违规”二字被消音,则返回该状态
  • MISS:本次消音未执行
  • NONE:无需消音
MuteExecutionDetailObject of MuteExecutionDetail-消音执行详情。

SystemSensitiveResults

参数类型示例值描述

MessageId

Long

182935****92413

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

说明

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

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

MuteExecutionStatus

String

PENDING

消音执行状态。取值如下:

  • PENDING:消音等待执行中
  • FULL_HIT:要消音的敏感词已全部执行
  • PARTIAL_HIT:要消音的敏感词已部分执行。例如:若敏感词为"违规消音",最终仅“违规”二字被消音,则返回该状态
  • MISS:本次消音未执行
  • NONE:无需消音
MuteExecutionDetailObject of MuteExecutionDetail-消音执行详情。

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 结果所属分类。已废弃。

MuteExecutionDetail

参数类型示例值描述
BeginPtsMsLong30000直播过程中开始消音的位置对应的呈现时间戳(Presentation Timestamp),单位为毫秒。例如,若 BeginPtsMs 取值为 30,000,表示系统从直播开始后的第 30 秒开始消音。
EndPtsMsLong35000直播过程中结束消音的位置对应的呈现时间戳(Presentation Timestamp),单位为毫秒。例如,若 EndPtsMs 取值为 35,000,表示系统从直播开始后的第 35 秒结束消音。
OccurredAtLong1787738400000开始执行消音的实际时间。Unix 时间戳,单位为毫秒。例如,若 OccurredAt 取值为 1787738400000,表示系统在 2026-08-26 10:00:00 时间点开始消音。
ReasonStringPARTIAL_BUFFER_OVERLAP未完整执行消音的排查原因。若完整执行了消音,则返回空。若返回具体原因,请联系直播质检技术支持排查。

请求示例

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.08.26 17:35:58
这个页面对您有帮助吗?
有用
有用
无用
无用