Release Notes and Announcements

Release Notes

Announcements

Product Introduction

Overview

Features

Strengths

Use Cases

Purchase Guide

Billing Overview

Purchase Instructions

Top Up and Purchase

Overdue Payments

Refund

Getting Started

Console Guide

Overview

Creating Tasks

Tasks

Orchestrations

Templates

Resource Packs

Video Evaluation

AIGC Content Generation

Terminal SDK

Subtitle Editing Tool

Usage Statistics

Cloud Access Management Sample

Integration Tutorials

Audio/Video Transcoding Integration

Audio/Video Enhancement Integration

Audio Separation Integration

Integration of Digital and Visible Watermarks

Media AI Integration Tutorial

Media Quality Inspection Integration

Terminal SDK integration

MPS Live Stream Recording integration

DRM integration

Media Quality Inspection Integration

PDF

Focus Mode

Font Size

Last updated: 2025-09-26 11:02:48

Scenario 1: VOD File Quality Inspection
Method 1: Initiating a Task in the Console
Step 1: Creating VOD Orchestration
1. Log in to the MPS console, click Create VOD Orchestration, and add a Media Quality Inspection node in the Actions field.
﻿
2. After the node is added, a new page pops up. Select a predefined system template or create a custom template based on the actual business scenario on this page. Then, save the settings.
﻿
3. Click Create at the bottom of the page after node configuration is completed to complete orchestration creation.
4. Return to the VOD orchestration list after the orchestration is created, find the newly created orchestration in the list, and click the switch to enable it. The orchestration will take effect in about 3-5 minutes after it is enabled.
﻿
Step 2: Initiating a VOD Quality Inspection Task
Upload VOD files requiring quality inspection to the trigger directory specified in the orchestration configuration after the orchestration takes effect. The uploaded files will be processed for quality inspection according to the configured node and template of the orchestration.
Step 3: Managing VOD Quality Inspection Tasks
Quality inspection tasks can be viewed on the VOD Processing Tasks page.
﻿
Method 2: Calling the API for Processing
Step 1: Initiating a VOD Quality Inspection Task
To initiate a processing task for video URLs or media files in COS, see ProcessMedia in API Documentation.
Request example:
﻿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
  }
}
Example description:
1. Type can be set to COS or URL. Fill in the source file path based on the Type value.
2. Definition indicates the ID of the template configured in the task. Templates are created by calling CreateQualityControlTemplate.
Response example:
﻿}
  "Response": {
    "TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
  }
}
Example description: TaskId indicates the unique ID of the task, which is used to query and manage tasks.
Step 2: Querying the Task Details
You can query the execution status and detailed result of a task by task ID. For more information, see DescribeTaskDetail in API Documentation.
Request example:
﻿POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTaskDetail
{
  "TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
}
Response example:
﻿}
  "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
      }
    }
  }
}
Viewing Quality Inspection Results
After initiating a quality inspection task, you can view the quality inspection result report on the VOD Task Management page.
﻿
Quality Inspection Results Report
The Quality Inspection Results Report shows inspection outcomes, offering video information and previews. Enabled inspection items allow users to check quality issue frequency and overall video rating.
﻿
If any issues are detected during video quality inspection, the specific time segments where problems occur will be displayed. You can click on the timeline with your mouse to jump directly to the corresponding video segment and review the specific issue.
On the quality inspection issue list page, you can view the precise reporting time for each quality inspection problem, enabling you to further pinpoint and analyze the issues.
Scenario 2: Live Stream Quality Inspection
Method 1: Initiating a Task in the Console
Step 1: Creating Live Stream Orchestration
1. Log in to the MPS console, click Create Live Orchestration, and add the Media Quality Inspection node in the Actions field.
﻿
2. After the node is added, a new page pops up. Select a predefined system template or create a custom template based on the actual business scenario on this page. Then, save the settings.
﻿
3. Click Create at the bottom of the page after node configuration is completed to complete orchestration creation.
4. Return to the live stream orchestration list after the orchestration is created, and find the newly created orchestration in the list.
﻿
Step 2: Creating a Live Stream Quality Inspection Task
Go to the Live Processing Tasks page, click Create task, enter the live stream address to be processed on the task creation page, select the live stream orchestration created in the previous step, complete other information as needed, and click Create to complete the creation.
﻿
Step 3: Managing Live Stream Quality Inspection Tasks
Quality inspection tasks can be viewed on the Live Processing Tasks page.
Method 2: Calling the API for Processing
Step 1: Initiating a Live Stream Quality Inspection Task
To initiate a live stream processing task, see ProcessLiveStream in API Documentation.
Request example:
﻿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
  }
}
Example description:
1. Url indicates the live stream address.
2. TaskNotifyConfig indicates the callback service address. When an issue is detected in the video stream, the issue information will be sent to this address in real time.
Response example:
﻿}
    "Response": {
        "TaskId": "24000002-live-procedure-813dc41e6fdc22dcf24aa6e9c61cp92"
    }
}
Example description: TaskId indicates the unique ID of the task, which is used to query and manage tasks.
Step 2: Parsing Live Stream Notifications and Performing Callback for Issues
After a message is received, the content of an MPS live stream processing event notification is parsed from the msgBody field in the message. For details, see ParseLiveStreamProcessNotification.
If TaskNotifyConfig is set when a live stream quality inspection task is initiated, the information on detected live stream issues detected will be sent to the configured address in real time.
Callback request example:
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"
      }
    ]
  }
}
Example description: QualityControlResultSet indicates the information on issues detected through content quality inspections. DiagnoseResultSet indicates the information on issues detected through format diagnosis.