1. 接口描述
接口请求域名: mps.tencentcloudapi.com 。
创建媒体质检模板,数量上限:50。
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateQualityControlTemplate。 |
Version | 是 | String | 公共参数,本接口取值:2019-06-12。 |
Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
Name | 是 | String | 媒体质检模板名称,长度限制:64 个字符。 示例值:质检模板 |
QualityControlItemSet.N | 是 | Array of QualityControlItemConfig | 媒体质检控制参数。 |
Comment | 否 | String | 媒体质检模板描述信息,长度限制:256 个字符。 示例值:模板 1 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Definition | Integer | 媒体质检模板唯一标识。 示例值:31 |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 创建媒体质检模板
输入示例
POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateQualityControlTemplate
<公共请求参数>
{
"Name": "example",
"Comment": "",
"QualityControlItemSet": [
{
"Type": "LowEvaluation",
"Switch": "ON"
},
{
"Type": "Mosaic",
"Switch": "OFF"
},
{
"Type": "CrashScreen",
"Switch": "OFF"
},
{
"Type": "Blur",
"Switch": "OFF"
},
{
"Type": "BlackWhiteEdge",
"Switch": "OFF"
},
{
"Type": "LowLighting",
"Switch": "OFF"
},
{
"Type": "HighLighting",
"Switch": "OFF"
},
{
"Type": "NoVoice",
"Switch": "OFF"
},
{
"Type": "LowVoice",
"Switch": "OFF"
},
{
"Type": "HighVoice",
"Switch": "OFF"
},
{
"Type": "VideoResolutionChanged",
"Switch": "OFF"
},
{
"Type": "AudioSampleRateChanged",
"Switch": "OFF"
},
{
"Type": "AudioChannelsChanged",
"Switch": "OFF"
},
{
"Type": "ParameterSetsChanged",
"Switch": "OFF"
},
{
"Type": "DarOrSarInvalid",
"Switch": "OFF"
},
{
"Type": "TimestampFallback",
"Switch": "OFF"
},
{
"Type": "DtsJitter",
"Switch": "OFF"
},
{
"Type": "PtsJitter",
"Switch": "OFF"
},
{
"Type": "AACDurationDeviation",
"Switch": "OFF"
},
{
"Type": "AudioDroppingFrames",
"Switch": "OFF"
},
{
"Type": "VideoDroppingFrames",
"Switch": "OFF"
},
{
"Type": "AVTimestampInterleave",
"Switch": "OFF"
},
{
"Type": "PtsLessThanDts",
"Switch": "OFF"
},
{
"Type": "ReceiveFpsJitter",
"Switch": "OFF"
},
{
"Type": "ReceiveFpsTooSmall",
"Switch": "OFF"
},
{
"Type": "FpsJitter",
"Switch": "OFF"
},
{
"Type": "StreamOpenFailed",
"Switch": "OFF"
},
{
"Type": "StreamEnd",
"Switch": "OFF"
},
{
"Type": "StreamParseFailed",
"Switch": "OFF"
},
{
"Type": "VideoFirstFrameNotIdr",
"Switch": "OFF"
},
{
"Type": "StreamNALUError",
"Switch": "OFF"
},
{
"Type": "TsStreamNoAud",
"Switch": "OFF"
},
{
"Type": "AudioStreamLack",
"Switch": "OFF"
},
{
"Type": "VideoStreamLack",
"Switch": "OFF"
},
{
"Type": "LackAudioRecover",
"Switch": "OFF"
},
{
"Type": "LackVideoRecover",
"Switch": "OFF"
},
{
"Type": "VideoBitrateOutofRange",
"Switch": "OFF"
},
{
"Type": "AudioBitrateOutofRange",
"Switch": "OFF"
},
{
"Type": "VideoDecodeFailed",
"Switch": "OFF"
},
{
"Type": "AudioDecodeFailed",
"Switch": "OFF"
},
{
"Type": "AudioOutOfPhase",
"Switch": "OFF"
},
{
"Type": "VideoDuplicatedFrame",
"Switch": "OFF"
},
{
"Type": "AudioDuplicatedFrame",
"Switch": "OFF"
},
{
"Type": "VideoRotation",
"Switch": "OFF"
},
{
"Type": "TsMultiPrograms",
"Switch": "OFF"
},
{
"Type": "Mp4InvalidCodecFourcc",
"Switch": "OFF"
},
{
"Type": "HLSBadM3u8Format",
"Switch": "OFF"
},
{
"Type": "HLSInvalidMasterM3u8",
"Switch": "OFF"
},
{
"Type": "HLSInvalidMediaM3u8",
"Switch": "OFF"
},
{
"Type": "HLSMasterM3u8Recommended",
"Switch": "OFF"
},
{
"Type": "HLSMediaM3u8Recommended",
"Switch": "OFF"
},
{
"Type": "HLSMediaM3u8DiscontinuityExist",
"Switch": "OFF"
},
{
"Type": "HLSMediaSegmentsStreamNumChange",
"Switch": "OFF"
},
{
"Type": "HLSMediaSegmentsPTSJitterDeviation",
"Switch": "OFF"
},
{
"Type": "HLSMediaSegmentsDTSJitterDeviation",
"Switch": "OFF"
},
{
"Type": "TimecodeTrackExist",
"Switch": "OFF"
}
]
}
输出示例
{
"Response": {
"Definition": 200090,
"RequestId": "7bb44c6c-92d0-4dad-99cf-88f569c6d3ad"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
InvalidParameter | 参数错误。 |
InvalidParameterValue | 参数取值错误。 |
InvalidParameterValue.AACDurationDeviation | AAC帧时间戳间隔不合理配置错误 |
InvalidParameterValue.AVTimestampInterleave | 音视频交织不合理配置错误 |
InvalidParameterValue.AudioBitrateOutofRange | 音频流码率超出范围配置错误 |
InvalidParameterValue.AudioChannelsChanged | 音频声道变化配置错误 |
InvalidParameterValue.AudioDecodeFailed | 音频解码错误配置错误 |
InvalidParameterValue.AudioDroppingFrames | 音频丢帧配置错误 |
InvalidParameterValue.AudioDuplicatedFrame | 音频流中存在重复帧配置错误 |
InvalidParameterValue.AudioOutOfPhase | 双通道音频相位相反配置错误 |
InvalidParameterValue.AudioSampleRateChanged | 音频采样率变化配置错误 |
InvalidParameterValue.AudioStreamLack | 无音频流配置错误 |
InvalidParameterValue.BlackWhiteEdge | 黑白边检测配置错误 |
InvalidParameterValue.Blur | 模糊检测配置错误 |
InvalidParameterValue.Comment | 参数错误:对该模板的描述。 |
InvalidParameterValue.CrashScreen | 花屏检测配置错误 |
InvalidParameterValue.DarOrSarInvalid | 视频的宽高比异常配置错误 |
InvalidParameterValue.DtsJitter | DTS抖动过大配置错误 |
InvalidParameterValue.EmptyDetectItem | 模板配置的使能检测项为空 |
InvalidParameterValue.FpsJitter | 通过PTS计算得到的流帧率抖动过大配置错误 |
InvalidParameterValue.HLSBadM3u8Format | 无效的m3u8文件配置错误 |
InvalidParameterValue.HLSInvalidMasterM3u8 | 无效的master m3u8文件配置错误 |
InvalidParameterValue.HLSInvalidMediaM3u8 | 无效的media m3u8文件配置错误 |
InvalidParameterValue.HLSMasterM3u8Recommended | master m3u8缺少标准推荐的参数配置错误 |
InvalidParameterValue.HLSMediaM3u8DiscontinuityExist | media m3u8存在EXT-X-DISCONTINUITY配置错误 |
InvalidParameterValue.HLSMediaM3u8Recommended | media m3u8缺少标准推荐的参数配置错误 |
InvalidParameterValue.HLSMediaSegmentsDTSJitterDeviation | 切片间DTS跳变且没有EXT-X-DISCONTINUITY配置错误 |
InvalidParameterValue.HLSMediaSegmentsPTSJitterDeviation | 切片间PTS跳变且没有EXT-X-DISCONTINUITY配置错误 |
InvalidParameterValue.HLSMediaSegmentsStreamNumChange | 切片的流数目发生变化配置错误 |
InvalidParameterValue.HighLighting | 亮度异常:过曝配置错误 |
InvalidParameterValue.HighVoice | 爆音检测配置错误 |
InvalidParameterValue.LackAudioRecover | 缺失音频流恢复配置错误 |
InvalidParameterValue.LackVideoRecover | 缺失视频流恢复配置错误 |
InvalidParameterValue.LowEvaluation | 无参考打分配置错误 |
InvalidParameterValue.LowLighting | 亮度异常:低光照配置错误 |
InvalidParameterValue.LowVoice | 低音检测配置错误 |
InvalidParameterValue.Mosaic | 马赛克检测配置错误 |
InvalidParameterValue.Mp4InvalidCodecFourcc | MP4中codec fourcc不符合Apple HLS要求配置错误 |
InvalidParameterValue.Name | 参数值错误:Name 超过长度限制。 |
InvalidParameterValue.NoVoice | 静音检测配置错误 |
InvalidParameterValue.ParameterSetsChanged | 流参数集信息发生变化配置错误 |
InvalidParameterValue.PtsJitter | PTS抖动过大配置错误 |
InvalidParameterValue.PtsLessThanDts | 媒体流的 pts 小于 dts配置错误 |
InvalidParameterValue.ReceiveFpsJitter | 网络接收帧率抖动过大配置错误 |
InvalidParameterValue.ReceiveFpsTooSmall | 网络接收视频帧率过小配置错误 |
InvalidParameterValue.StreamEnd | 流结束配置错误 |
InvalidParameterValue.StreamNALUError | NALU起始码错误配置错误 |
InvalidParameterValue.StreamOpenFailed | 流打开失败配置错误 |
InvalidParameterValue.StreamParseFailed | 流解析失败配置错误 |
InvalidParameterValue.SvgTemplate | 参数值错误:SVG 为空。 |
InvalidParameterValue.TimecodeTrackExist | MP4存在tmcd轨道配置错误 |
InvalidParameterValue.TimestampFallback | DTS时间戳回退配置错误 |
InvalidParameterValue.TsMultiPrograms | MPEG2-TS流有多个program配置错误 |
InvalidParameterValue.TsStreamNoAud | mpegts的H26x流缺失 AUD NALU配置错误 |
InvalidParameterValue.UnknownCategory | 未知诊断类别 |
InvalidParameterValue.VideoBitrateOutofRange | 视频流码率超出范围配置错误 |
InvalidParameterValue.VideoDecodeFailed | 视频解码错误配置错误 |
InvalidParameterValue.VideoDroppingFrames | 视频丢帧配置错误 |
InvalidParameterValue.VideoDuplicatedFrame | 视频流中存在重复帧配置错误 |
InvalidParameterValue.VideoFirstFrameNotIdr | 首帧不是IDR帧配置错误 |
InvalidParameterValue.VideoFreezedFrame | 视频冻结配置错误 |
InvalidParameterValue.VideoResolutionChanged | 视频分辨率变化配置错误 |
InvalidParameterValue.VideoRotation | 视频画面旋转配置错误 |
InvalidParameterValue.VideoStreamLack | 无视频流配置错误 |
LimitExceeded.TooMuchTemplate | 超过限制值:模板数超限。 |