GetVideoReport - 获取视频质检报告--企业直播-火山引擎

文档中心

企业直播

视频质检 API

GetVideoReport - 获取视频质检报告

调用 GetVideoReport 接口，获取指定视频质检任务的质检报告，包含机审详情和人审详情。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。
前提条件：确保当前账号已开通质检服务。若当前账号为子账号，请同时确保主账号已在直播质检平台为该子账号授权，详见为子账号授权。否则账号将提示“暂无使用权限,请联系客服人员申请开通”。

请求说明

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

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetVideoReport`	接口名称。当前 API 的名称为 `GetVideoReport`。
Version	String	是	`2024-08-01`	接口版本。当前 API 的版本为 `2024-08-01`。
ProjectName	String	是	`1827*****8608457`	视频质检项目名称。您可通过调用 ListProjects 接口获取项目名称。
TaskId	Long	是	`397**671`	视频质检任务 ID。您可通过调用 CreateVideoTask 或 ListVideoTasks 获取。

返回参数

参数	类型	示例值	描述
TaskDetail	Object of TaskDetail	`-`	任务详情。
TaskResult	Object of TaskResult	`-`	任务结果。
RuleResultDetails	Array of RuleResultDetails	`-`	规则结果。

TaskDetail

参数	类型	示例值	描述
ProjectName	String	`182701****608457`	视频质检项目名称。
TaskId	Long	`39737671`	视频质检任务 ID。
TaskName	String	`任务 A`	视频质检任务名称。
TaskType	Integer	`1`	任务类型。固定取值为 `1`，表示对视频进行质检。
TaskTypeDesc	String	`审核任务 1`	任务类型描述。
Status	Integer	`4`	任务状态。取值如下： `1`：待机审 `2`：机审中 `3`：待人审 `4`：已完成（人审已完成） `5`：任务执行失败
ScenarioId	Long	`1`	审核场景 ID。
CreatedTime	Long	`1744012851`	任务创建时间。Unix 时间戳，单位为秒。
UpdatedTime	Long	`1744012851`	任务更新时间（任务更新指任务状态变化等情况）。Unix 时间戳，单位为秒。
CallbackURL	String	`https://www.example.com`	CreateVideoTask 接口传入的视频质检消息的回调地址。详见视频质检消息回调。
Extra	String	`extra`	CreateVideoTask 接口传入的业务相关信息。
Tags	Array of Tags	`-`	质检任务绑定的标签。

TaskResult

参数	类型	示例值	描述
MachineStartTime	Long	`1744016864`	机审开始时间。Unix 时间戳，单位为秒。
MachineEndTime	Long	`1744016900`	机审完成时间。Unix 时间戳，单位为秒。
Cost	Integer	`36`	机审耗时，单位为秒。
ManualEndTime	Long	`1744026900`	最近一次人审完成时间。Unix 时间戳，单位为秒。参数取值为 `0`，表示未进行人审。
RecordURL	String	`https://www.example.com`	M3U8 格式的视频回放点播播放地址，包含 HTTPS 协议头。有效期为 7 天，请及时下载保存。
ASRResult	Object of ASRResult	`-`	语音识别结果。
ManualDetails	Array of ManualDetails	`-`	人审记录。
FinalManualStatus	Integer	`2`	人审状态。取值如下： `0`：未进行人审，即无人审记录 `1`：人审通过 `2`：人审不通过

RuleResultDetails

参数	类型	示例值	描述
RuleName	String	`敏感词`	规则名称。
FinalManualStatus	Integer	`2`	人审状态。取值如下： `0`：未进行人审，即无人审记录 `1`：人审通过 `2`：人审不通过
ManualDetails	Array of ManualDetails	`-`	人审记录。
FinalMachineStatus	Integer	`2`	机审状态。取值如下： `0`：未进行机审 `1`：机审通过 `2`：机审不通过
MachineDetails	Object of MachineDetails	`-`	机审记录。
RuleId	Long	`101`	规则 ID。
RuleType	Integer	`2`	规则类型。取值如下： `1`：系统敏感词 `2`：自定义敏感词 `3`：豆包文字分析，即用豆包大模型检测视频语音识别的文本 `4`：豆包图像分析，即用豆包大模型检测视频画面 `5`：OCR 文字识别 `6`：OCR 滚动字幕
ViolationType	Integer	`1`	规则策略。取值如下： `0`：分析。机审触发本规则，将仅在质检报告中显示机审分析结果 `1`：违规。机审触发本规则，将判定为机审不通过

参数	类型	示例值	描述
TagId	Long	`121`	标签 ID。
TagName	String	`标签 B`	标签名称。
ParentTagId	Long	`26`	父标签 ID。
ParentTagName	String	`标签 A`	父标签名称。

ASRResult

参数	类型	示例值	描述
Text	String	`分句 1，分句 2。`	完整语音识别文字内容。
Utterances	Array of Utterances	`-`	语音识别分句详情。

ManualDetails

参数	类型	示例值	描述
MessageId	Long	`182935****92411`	人审审核消息 ID。全局唯一。说明若 `MessageId` 返回值为 `0`，表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务，再调用本接口获取该字段的值。
ManualComment	String	`存在违规内容`	人审审核意见。
Auditor	String	`主账号`	审核人。
UserId	Long	`0`	审核人用户 ID。取值为 `0`表示主账号。
ManualSource	Integer	`3`	人审意见的来源。取值如下： `3`：质检报告任务审核，或通过 SubmitVideoAudit 接口的 `AuditStatus` 参数提交人审意见 `4`：质检报告规则审核
CreatedTime	Long	`1744016900`	人审记录创建时间。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` 时，返回该参数。
OCRTextRecognitionResults	Array of OCRTextRecognitionResults	`-`	OCR 文字识别检测结果。说明仅当 `MachineType` 取值为 `5` 时，返回该参数。
OCRBottomSubtitleResults	Array of OCRBottomSubtitleResults	`-`	OCR 滚动字幕检测结果。说明仅当 `MachineType` 取值为 `6` 时，返回该参数。
CustomSensitiveResults	Array of CustomSensitiveResults	`-`	自定义敏感词的检测结果。说明仅当 `MachineType` 取值为 `2` 时，返回该参数。
SystemSensitiveResults	Array of SystemSensitiveResults	`-`	系统敏感词的检测结果。说明仅当 `MachineType` 取值为 `1` 时，返回该参数。

Utterances

参数	类型	示例值	描述
StartTime	Long	`60`	当前分句在视频中出现的时间点，表示从视频开始到该分句显示的时间间隔，单位为秒。例如视频从 00:00 开始播放，某分句在 01:30 出现，则参数值为 `90`。
EndTime	Long	`70`	当前分句在视频中消失的时间点，表示从视频开始到该分句消失的时间间隔，单位为秒。例如视频从 00:00 开始播放，某分句在 01:30 消失，则参数值为 `90`。
Text	String	`分句 1`	分句文字。

AnalysisTexts

参数	类型	示例值	描述
MessageId	Long	`182935****92412`	文字分析的质检消息 ID。全局唯一。说明若 `MessageId` 返回值为 `0`，表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务，再调用本接口获取该字段的值。
Text	String	`文本内容`	文字分析的文本内容。
Type	String	`分类 A`	文字分析的所属分类。已废弃。
StartTime	Long	`60`	文本内容在视频中出现的时间点，表示从视频开始到该文本出现的时间间隔，单位为秒。例如视频从 00:00 开始播放，某文本在 01:30 出现，则参数值为 `90`。
EndTime	Long	`70`	文本内容在视频中消失的时间点，表示从视频开始到该文本消失的时间间隔，单位为秒。例如视频从 00:00 开始播放，某文本在 01:30 消失，则参数值为 `90`。
Description	String	`涉及营销广告`	违规原因。

AnalysisImages

参数	类型	示例值	描述
MessageId	Long	`182935****92413`	图像分析的质检消息 ID。全局唯一。说明若 `MessageId` 返回值为 `0`，表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务，再调用本接口获取该字段的值。
ImageURLs	Array of String	`["https://www.example.com/a.png","https://www.example.com/b.png"]`	违规的图像链接，包含协议头。有效期为 24 小时，请尽快下载保存。
Type	String	`分类 A`	图像的所属分类。已废弃。
StartTime	Long	`60`	图像在视频中出现的时间点，表示从视频开始到该图像出现的时间间隔，单位为秒。例如视频从 00:00 开始播放，某图像在 01:30 出现，则参数值为 `90`。
EndTime	Long	`90`	图像在视频中消失的时间点，表示从视频开始到该图像消失的时间间隔，单位为秒。例如视频从 00:00 开始播放，某图像在 01:30 消失，则参数值为 `90`。
Description	String	`出现非品牌物料`	违规原因。

OCRTextRecognitionResults

参数	类型	示例值	描述
MessageId	Long	`182935****92416`	OCR 文字识别的质检消息 ID。全局唯一。
ImageURLs	Array of String	`[ "https://www.example.com/ocr-a.png" ]`	若在 OCR 文字识别规则检测过程中，画面出现了您指定的预设文字，则会返回关键画面截图的 URL。链接有效期为 24 小时，请尽快下载保存。
StartTime	Long	`60`	触发 OCR 文字识别规则的时间点，表示从视频开始到触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。
EndTime	Long	`70`	OCR 文字识别规则结束触发的时间点，表示从视频开始到结束触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 结束，则参数值为 `90`。
Description	String	`检测到违规 OCR 文字`	违规原因。
Type	String	`分类 A`	OCR 结果所属分类。已废弃。

OCRBottomSubtitleResults

参数	类型	示例值	描述
MessageId	Long	`182935****92416`	OCR 滚动字幕的质检消息 ID。全局唯一。
ImageURLs	Array of String	`[ "https://www.example.com/ocr-a.png" ]`	违规的滚动字幕截图链接，包含协议头。链接有效期为 24 小时，请尽快下载保存。
StartTime	Long	`60`	违规的滚动字幕开始出现的时间。单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。
EndTime	Long	`70`	OCR 滚动字幕规则结束触发的时间点，表示从视频开始到结束触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 结束，则参数值为 `90`。
Description	String	`检测到违规滚动字幕`	违规原因。
Type	String	`分类 A`	OCR 结果所属分类。已废弃。

CustomSensitiveResults

参数	类型	示例值	描述
MessageId	Long	`182935****92415`	自定义敏感词检测的质检消息 ID。全局唯一。说明若 `MessageId` 返回值为 `0`，表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务，再调用本接口获取该字段的值。
SensitiveWord	String	`敏感词`	命中的自定义敏感词。
Text	String	`文本内容`	包含自定义敏感词的语音识别文本内容。
StartTime	Integer	`60`	触发语音识别文本的时间点，表示从视频开始到触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。

SystemSensitiveResults

参数	类型	示例值	描述
MessageId	Long	`182935****92413`	系统敏感词检测的质检消息 ID。全局唯一。说明若 `MessageId` 返回值为 `0`，表示当前任务因时间限制不支持返回该字段。建议重新创建最新的质检任务，再调用本接口获取该字段的值。
Text	String	`文本内容`	包含系统敏感词的语音识别文本内容。
StartTime	Integer	`60`	触发语音识别文本的时间点，表示从视频开始到触发检测的时间间隔，单位为秒。例如视频从 00:00 开始播放，本次触发检测在 01:30 开始，则参数值为 `90`。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "GetVideoReport",
        "Version": "2024-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1"
    },
    "Result": {
        "TaskDetail": {
            "TaskId": 39737671,
            "TaskName": "任务 A",
            "ProjectName": "182701****608457",
            "TaskType": 1,
            "TaskTypeDesc": "审核任务 1",
            "Status": 4,
            "ScenarioId": 1,
            "CreatedTime": 1744012851,
            "UpdatedTime": 1744012851,
            "CallbackURL": "https://www.example.com",
            "Extra": "extra",
            "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": [
                {
                    "ManualComment": "存在违规内容",
                    "Auditor": "主账号",
                    "UserId": 0,
                    "ManualSource": 3,
                    "CreatedTime": 1744016900,
                    "ManualStatus": 2,
                    "MessageId": 182935
                }
            ],
            "FinalManualStatus": 2
        },
        "RuleResultDetails": [
            {
                "RuleName": "敏感词",
                "FinalManualStatus": 2,
                "ManualDetails": [
                    {
                        "ManualDetails": "审核不通过。",
                        "Auditor": "主账户",
                        "UserId": 0,
                        "ManualSource": 1,
                        "CreatedTime": 1744016900,
                        "ManualStatus": 2,
                        "MessageId": 182935534592411
                    }
                ],
                "FinalMachineStatus": 2,
                "MachineDetails": {
                    "MachineType": 2,
                    "AnalysisTexts": [
                        {
                            "Text": "文本内容",
                            "Type": "分类 A",
                            "StartTime": 60,
                            "EndTime": 70,
                            "MessageId": 182935,
                            "Description": "涉及营销广告"
                        }
                    ],
                    "AnalysisImages": [
                        {
                            "ImageURLs": [
                                "https://www.example.com/a.png",
                                "https://www.example.com/b.png"
                            ],
                            "Type": "分类 A",
                            "StartTime": 60,
                            "EndTime": 90,
                            "MessageId": 182935,
                            "Description": "出现非品牌物料"
                        }
                    ],
                    "CustomSensitiveResults": [
                        {
                            "SensitiveWord": "敏感词",
                            "Text": "文本内容",
                            "StartTime": 60,
                            "MessageId": 182935
                        }
                    ],
                    "SystemSensitiveResults": [
                        {
                            "Text": "文本内容",
                            "StartTime": 60,
                            "MessageId": 182935
                        }
                    ],
                    "OCRTextRecognitionResults": [
                        {
                            "MessageId": 182935,
                            "ImageURLs": [
                                "https://www.example.com/ocr-a.png"
                            ],
                            "StartTime": 60,
                            "EndTime": 70,
                            "Description": "检测到违规 OCR 文字",
                            "Type": "分类 A"
                        }
                    ],
                    "OCRBottomSubtitleResults": [
                        {
                            "MessageId": 182935,
                            "ImageURLs": [
                                "https://www.example.com/ocr-a.png"
                            ],
                            "StartTime": 60,
                            "EndTime": 70,
                            "Description": "检测到违规滚动字幕",
                            "Type": "分类 A"
                        }
                    ]
                },
                "RuleId": 101,
                "RuleType": 2,
                "ViolationType": 1
            }
        ]
    }
}

错误码

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

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

400 TaskIdInvalidError invalid task id 质检任务不存在，或不属于当前项目。请检查 TaskId 的值。

400 TaskTypeInvalidError invalid task type 当前任务不是视频质检任务。本接口仅支持对视频（非直播）质检任务提交人审意见。

状态码	错误码	错误信息	说明
400	TaskIdInvalidError	invalid task id	质检任务不存在，或不属于当前项目。请检查 `TaskId` 的值。
400	TaskTypeInvalidError	invalid task type	当前任务不是视频质检任务。本接口仅支持对视频（非直播）质检任务提交人审意见。
400	ReportNotFoundError	report not found	视频质检任务未执行完毕或执行失败，导致未生成质检报告。如果任务未执行完毕，请等待任务执行完毕后，再重新调用该接口。如果任务执行失败，请重新调用 CreateVideoTask 接口再次发起质检任务。

400

ReportNotFoundError

report not found

视频质检任务未执行完毕或执行失败，导致未生成质检报告。

如果任务未执行完毕，请等待任务执行完毕后，再重新调用该接口。
如果任务执行失败，请重新调用 CreateVideoTask 接口再次发起质检任务。

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

这个页面对您有帮助吗？

有用

无用

企业直播

注意事项 #

请求说明 #

请求参数 #

Query #

返回参数 #

TaskDetail #

TaskResult #

RuleResultDetails #

Tags #

ASRResult #

ManualDetails #

MachineDetails #

Utterances #

AnalysisTexts #

AnalysisImages #

OCRTextRecognitionResults #

OCRBottomSubtitleResults #

CustomSensitiveResults #

SystemSensitiveResults #

请求示例 #

返回示例 #

错误码 #