动态与公告

产品动态

产品公告

产品简介

产品概述

产品功能

产品优势

应用场景

购买指南

计费说明

购买指引

续费说明

欠费说明

退费说明

快速入门

控制台指南

概览

创建任务

任务管理

编排管理

模板管理

资源包管理

视频评测

AIGC 内容生成

终端 SDK

字幕编辑工具

用量统计

访问管理示例

接入教程

音视频转码接入

音视频增强接入

音频分离接入

数字水印及明水印接入

媒体 AI 接入教程

媒体质检接入

终端 SDK 接入

直播流录制接入

DRM 接入

其他接入教程

场景实践教程

画质提升场景

音视频成本优化场景

短剧出海场景

生成式场景

在线教育场景

API 文档

History

Introduction

API Category

调用方式

发起处理任务相关接口

任务管理相关接口

转码增强模板相关接口

水印模板相关接口

截图模板相关接口

媒体AI模板相关接口

媒体AI-热词库相关接口

媒体AI-样本管理相关接口

媒体质检模板相关接口

直播录制模板相关接口

编排管理相关接口

数据统计相关接口

媒体传输-安全组管理相关接口

解析事件通知相关接口

图片处理模板相关接口

AI创作相关接口

其他接口

Data Types

Error Codes

其他说明文档

WebSocket 识别协议

常见问题

产品基础相关

账号授权相关

任务配置相关

发起任务相关

任务结果查看相关

媒体质检接入

PDF

聚焦模式

字号

最后更新时间： 2025-09-26 11:02:48

场景一：点播文件质检
方法1：控制台发起任务
步骤1：创建点播服务编排
1. 登录媒体处理控制台 创建点播服务编排，在服务编排任务配置中插入“媒体质检”编排节点。
﻿
2. 添加节点后，会弹出新的页面，在页面中根据业务实际场景选择系统预设模板或者创建自定义模板，并保存设置。
﻿
3. 节点配置完成后，单击页面下方创建，完成创建服务编排。
4. 服务编排创建完成后返回点播服务编排列表页，在列表页中找到刚创建的编排，单击“启用”，按钮开启后约3 - 5分钟编排生效。
﻿
步骤2：发起点播质检任务
待服务编排生效后，即可往编排配置中的触发目录中上传需要质检的点播文件，此时将会按照编排中节点及模板的配置内容对上传的文件进行质检处理。
步骤3：管理点播质检任务
质检任务可以在 点播任务管理 中进行查看。
﻿
方法2：调用 API 处理
步骤1：发起点播质检任务
对 URL 视频链接 或 COS 中的媒体文件发起处理任务，可参见 API 文档 发起媒体处理。
请求示例：
﻿POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ProcessMedia
{
  "InputInfo": {
    "Type": "COS",
    "CosInputInfo": {
      "Bucket": "test-<appid>",
      "Region": "ap-shanghai",
      "Object": "/video/test.mp4"
    }
  },
  "AiQualityControlTask": {
    "Definition": 10
  }
}
示例说明：
1. Type 可以为 COS 和 URL，根据类型填写源文件路径。
2. Definition 为任务配置模板 ID，模板通过 CreateQualityControlTemplate 生成。
响应示例：
﻿{
  "Response": {
    "TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
  }
}
示例说明：TaskId 是唯一任务标记，可用于查询和管理任务。
步骤2：查询任务详情
通过任务 ID 查询任务的执行状态和结果的详细信息，可参见 API 文档 查询任务详情。
请求示例：
﻿POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTaskDetail
{
  "TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
}
响应示例：
﻿{
  "Response": {
    "WorkflowTask": {
      "Output": {
        "QualityControlResultSet": [
          {
            "Type": "BackWhiteEdge",
            "QualityControlItems": [
              {
                "Confidence": 100,
                "StartTimeOffset": 12,
                "EndTimeOffset": 12
              }
            ]
          }
        ],
        "ContainerDiagnoseResultSet": [
          {
            "Category": "StreamAbnormalCharacteristics",
            "DateTimeSet": [],
            "SeverityLevel": "Warning",
            "TimestampSet": [
              11.006
            ],
            "Type": "AudioDuplicatedFrame"
          }
        ],
        "QualityEvaluationScore": 68
      }
    }
  }
}
查看质检结果
在发起质检任务后，可以在 点播任务管理 页面，查看质检结果报告。
﻿
质检结果报告
质检结果报告，是对质检结果的完整展现，可以查询视频的基本信息，和预览视频。在开启了对应的检测项后，能够查看对应质检问题的出现次数和视频整体评分。
﻿
如视频质检出现问题，会显示每项视频问题出现的时间段。支持鼠标点击时间轨道，跳转到对应的视频片段查看具体问题。
在质检问题列表页面，可以查看每一条质检问题上报的具体时间，帮助您对质检问题做进一步的定位和分析。
场景二：直播流质检
方法1：控制台发起任务
步骤1：创建直播服务编排
1. 登录媒体处理控制台 创建直播服务编排，在服务编排任务配置中插入“媒体质检”编排节点。
﻿
2. 添加节点后，会弹出新的页面，在页面中根据业务实际场景选择系统预设模板或者创建自定义模板，并保存设置。
﻿
3. 节点配置完成后，单击页面下方创建，完成创建服务编排。
4. 服务编排创建完成后返回直播服务编排列表页，列表页中可以找到刚创建的直播服务编排。
﻿
步骤2：创建直播质检任务
进入 直播任务管理，单击创建任务，在创建任务页面输入要处理的直播流地址，选择前置步骤中创建的直播服务编排（其他配置根据自身业务需要选择填写），单击创建即可完成。
﻿
步骤3：管理直播质检任务
质检任务可以在 直播任务管理 中进行查看。
方法2：调用 API 处理
步骤1：发起直播质检任务
对直播流媒体发起处理任务，可参见 API 文档 对直播流发起处理。
请求示例：
﻿POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ProcessLiveStream
{
  "Url": "rtmp://tlivecloud.com/live/test",
  "TaskNotifyConfig": {
    "NotifyType": "URL",
    "NotifyUrl": "http://tlivecloud.com/callback"
  },
  "AiQualityControlTask": {
    "Definition": 10
  }
}
示例说明：
1. Url 为直播流地址。
2. TaskNotifyConfig 为回调服务地址，当视频流诊断出异常时，将异常信息实时回调给该地址。
响应示例：
﻿{
    "Response": {
        "TaskId": "24000002-live-procedure-813dc41e6fdc22dcf24aa6e9c61cp92"
    }
}
示例说明：TaskId 是唯一任务标记，可用于查询和管理任务。
步骤2：解析直播异常回调
获取到消息后，从消息的 msgBody 字段中解析出 MPS 直播流处理事件通知的内容，可参见 API 文档 解析直播流处理结果。
如果发起直播质检任务时配置了 TaskNotifyConfig，当视频流诊断出异常时，会将异常信息实时回调给配置的地址。
回调请求示例：
POST / HTTP/1.1
Content-Type: application/json
﻿
{
  "NotificationType": "AiQualityControlResult",
  "TaskId": "24000002-procedure-live-813dc41e6fdc22dcf24aa6e9c61cp92",
  "AiQualityControlResultInfo": {
    "QualityControlResultSet": [
      {
        "Type": "BackWhiteEdge",
        "QualityControlItems": [
          {
            "Confidence": 100,
            "StartTimeOffset": 12,
            "EndTimeOffset": 12
          }
        ]
      }
    ],
    "DiagnoseResultSet": [
      {
        "Category": "StreamStatusException",
        "Type": "StreamOpenFailed",
        "Timestamp": 0,
        "Description": "Open url failed.",
        "DateTime": "2023-11-06T06:37:28Z",
        "SeverityLevel": "Fatal"
      }
    ]
  }
}
示例说明：QualityControlResultSet 为内容质检的异常信息，DiagnoseResultSet 为格式诊断的异常信息。