You need to enable JavaScript to run this app.
企业直播

企业直播

复制全文
API
GetMergedReport - 获取多个任务质检报告
复制全文
GetMergedReport - 获取多个任务质检报告

调用 GetMergedReport 接口,获取多个任务的合并质检报告,包含违规占比、话术分析占比、图像分析占比等。

注意事项

  • 请求频率:单用户请求频率限制为 10 次/秒
  • 前提条件:当任务状态为待人审或人审已完成时,即满足以下任一条件时,可调用当前接口,获取指定任务的质检报告。

请求说明

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

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringGetMergedReport接口名称。当前 API 的名称为 GetMergedReport
VersionString2024-08-01接口版本。当前 API 的版本为 2024-08-01

Body

参数类型是否必选示例值描述

TaskIds

Array of Long

[397**671,39**7672]

任务 ID。您可通过调用 CreateTaskListTasks 获取 ID。

说明

最多支持合并 5 个任务的质检报告。

返回参数

参数类型示例值描述
TaskDetailsArray of TaskDetails-任务详情。
TaskResultObject of TaskResult-合并后的任务结果。
RuleResultDetailsArray of RuleResultDetails-合并后的规则结果。

TaskDetails

参数类型示例值描述
ProjectNameString182701****608457项目名称。
TaskIdLong397**671任务 ID。
TaskNameString任务 A任务名称。

TaskType

Integer

2

任务类型。取值如下:

  • 1:视频审核(暂不支持)
  • 2:直播审核
TaskTypeDescString审核任务 1任务类型描述。

Status

Integer

4

任务状态。取值如下:

  • 1:待机审
  • 2:机审中
  • 3:待人审
  • 4:已完成(人审已完成)
  • 5:任务执行失败
ScenarioIdLong1审核场景 ID。
LivePullURLStringhttps://www.example.com直播拉流地址。
CreatedTimeLong1744012851任务创建时间。Unix 时间戳,单位为秒。
UpdatedTimeLong1744012851任务更新时间(任务更新指任务状态变化等情况)。Unix 时间戳,单位为秒。

CallbackURL

String

https://www.example.com

回调地址,支持 HTTP 和 HTTPS 协议头。
在任务开始到结束的整个生命周期中,当发生以下事件时,直播质检会将任务状态消息、机审违规消息,以及人审处置意见消息以 POST 方式提交至该地址:

  • 质检任务状态变化,包括任务开始、任务结束和任务执行失败
  • 触发机审违规消息
  • 提交人审处置意见
ExtraStringextraCreateTask 接口传入的业务相关信息。

ActivityId

Long

1778123494933

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

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

ActivityName

String

直播间 A

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

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

TaskResult

参数类型示例值描述
MachineStartTimeLong1744016864所有任务中,最早的机审开始时间。Unix 时间戳,单位为秒。
MachineEndTimeLong1744016900所有任务中,最晚的机审完成时间。Unix 时间戳,单位为秒。
CostInteger36所有任务中,机审的总耗时。单位为秒。

ManualEndTime

Long

1744026900

所有任务中,最近一次人审完成时间。Unix 时间戳,单位为秒。

说明

如果所有任务均未进行人审,则参数取值为 0

RecordURLs

Array of String

["https://www.example1.com","https://www.example2.com"]

M3U8 格式的视频回放地址,包含 HTTPS 协议头。有效期为 7 天,请尽快下载保存。

说明

每个任务返回一个回放地址。

ASRResultsArray of ASRResults-语音识别结果。

StatisticalData

Object of StatisticalData

-

合并后的统计数据。

说明

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

ManualDetailsArray of ManualDetails-人审记录。

FinalManualStatus

Integer

2

合并后最终的人审状态。取值如下:

  • 0:未进行人审,即无人审记录
  • 1:人审通过,即所有任务中,每次人审均通过
  • 2:人审不通过。所有任务中,有一次人审不通过,则取值为 2

RuleResultDetails

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

FinalManualStatus

Integer

2

合并后最终的人审状态。取值如下:

  • 0:未进行人审,即无人审记录
  • 1:人审通过,即所有任务中,每次人审均通过
  • 2:人审不通过。所有任务中,有一次人审不通过,则取值为 2

FinalMachineStatus

Integer

2

机审状态。取值如下:

  • 0:未进行机审
  • 1:机审通过
  • 2:机审不通过
ManualDetailsArray of ManualDetails-人审记录。
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父标签名称。

ASRResults

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

StatisticalData

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

ManualDetails

参数类型示例值描述

MessageId

Long

1829*****592411

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

说明

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

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

UserId

Long

0

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

ManualSource

Integer

1

人审来源。取值如下:

  • 1:监控台任务审核
  • 2:监控台规则审核
  • 3:质检报告任务审核
  • 4:质检报告规则审核
CreatedTimeLong1744016900人审记录创建时间。Unix 时间戳,单位为秒。

ManualStatus

Integer

2

人审状态。取值如下:

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

MachineDetails

参数类型示例值描述

MachineType

Integer

2

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

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

AnalysisTexts

Array of AnalysisTexts

-

语音识别文本的检测结果。

说明

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

AnalysisImages

Array of AnalysisImages

-

图像的检测结果。

说明

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

CustomSensitiveResults

Array of CustomSensitiveResults

-

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

说明

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

SystemSensitiveResults

Array of SystemSensitiveResults

-

系统敏感词的检测结果。

说明

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

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

1829*****592411

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

说明

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

TextString文本内容语音识别的文本内容。
TypeString分类 A语音识别文本的所属分类。已废弃。
AbsoluteStartTimeLong1744016864语音识别文本的出现时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016870语音识别文本的结束时间。Unix 时间戳,单位为秒。
DescriptionString涉及营销广告违规原因。

AnalysisImages

参数类型示例值描述

MessageId

Long

1829*****592411

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

说明

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

ImageURLsArray of String["https://www.example.com/a.png","https://www.example.com/b.png"]图像的截图链接。有效期为 24 小时,请尽快下载保存。
TypeString分类 A图像的所属分类。已废弃。
AbsoluteStartTimeLong1744016864图像的出现时间。Unix 时间戳,单位为秒。
AbsoluteEndTimeLong1744016894图像的结束时间。Unix 时间戳,单位为秒。
DescriptionString出现非品牌物料违规原因。

CustomSensitiveResults

参数类型示例值描述

MessageId

Long

1829*****592411

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

说明

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

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

SystemSensitiveResults

参数类型示例值描述

MessageId

Long

1829*****592411

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

说明

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

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

请求示例

POST https://livesaas.volcengineapi.com/?Action=GetMergedReport&Version=2024-08-01
{
    "TaskIds": [
        397**671,
        397**672
    ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GetMergedReport",
    "Version": "2024-08-01",
    "Service": "livesaas",
    "Region": "cn-north-1"
  },
  "Result": {
    "TaskDetails": [
      {
        "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": 1778123494933,
        "ActivityName": "直播间 A",
        "Tags": [
          {
            "TagId": 121,
            "TagName": "标签 B",
            "ParentTagId": 26,
            "ParentTagName": "标签 A"
          }
        ]
      }
    ],
    "TaskResult": {
      "MachineStartTime": 1744016864,
      "MachineEndTime": 1744016900,
      "Cost": 36,
      "ManualEndTime": 1744026900,
      "StatisticalData": {
        "ViolationList": [
          {
            "Title": "分类 A",
            "Count": 10
          }
        ],
        "ImageLLMAnalysisList": [
          {
            "Title": "分类 B",
            "Count": 10
          }
        ],
        "TextLLMAnalysisList": [
          {
            "Title": "分类 C",
            "Count": 10
          }
        ]
      },
      "ManualDetails": [
        {
          "MessageId": 1829*****592411,
          "ManualComment": "存在违规内容",
          "Auditor": "主账号",
          "UserId": 0,
          "ManualSource": 1,
          "CreatedTime": 1744016900,
          "ManualStatus": 2
        }
      ],
      "FinalManualStatus": 2,
      "ASRResults": [
        {
          "Text": "分句 1,分句 2。",
          "Utterances": [
            {
              "StartTime": 60,
              "EndTime": 70,
              "Text": "分句 1"
            }
          ]
        }
      ],
      "RecordURLs": [
        "https://www.example1.com",
        "https://www.example2.com"
      ]
    },
    "RuleResultDetails": [
      {
        "RuleName": "敏感词",
        "FinalManualStatus": 2,
        "ManualDetails": [
          {
            "MessageId": 1829*****592411,
            "ManualDetails": "审核不通过。",
            "Auditor": "主账户",
            "UserId": 0,
            "ManualSource": 1,
            "CreatedTime": 1744016900,
            "ManualStatus": 2
          }
        ],
        "FinalMachineStatus": 2,
        "MachineDetails": {
          "MachineType": 2,
          "AnalysisTexts": [
            {
              "MessageId": 1829*****592411,
              "Text": "文本内容",
              "AbsoluteStartTime": 1744016864,
              "AbsoluteEndTime": 1744016870,
              "Description":"涉及营销广告"
            }
          ],
          "AnalysisImages": [
            {
              "MessageId": 1829*****592411,
              "AbsoluteStartTime": 1744016864,
              "AbsoluteEndTime": 1744016894,
              "Description":"出现非品牌物料",
              "ImageURLs": [
                "https://www.example.com/a.png",
                "https://www.example.com/b.png"
              ]
            }
          ],
          "CustomSensitiveResults": [
            {
              "MessageId": 1829*****592411,
              "Text": "文本内容",
              "AbsoluteStartTime": 1744016864,
              "StartTime": 60,
              "SensitiveWord": "敏感词"
            }
          ],
          "SystemSensitiveResults": [
            {
              "MessageId": 1829*****592411,
              "Text": "文本内容",
              "AbsoluteStartTime": 1744016864,
              "StartTime": 60
            }
          ]
        },
        "RuleType": 2,
        "ViolationType": 1,
        "RuleId": 101
      }
    ]
  }
}

错误码

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

状态码错误码错误信息说明
400TaskIdsNumberExceedErrortaskIDs number exceed limit待合并质检报告的任务数量已超出上限 5。请减少 TaskIds中的任务 ID。
最近更新时间:2026.03.13 11:51:26
这个页面对您有帮助吗?
有用
有用
无用
无用