You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /
  • 视频点播

获取转码结果

最近更新时间：2024.01.09 14:56:12

首次发布时间：2022.06.27 21:04:56

我的收藏

此接口用于获取转码结果。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

  • 请求方式：GET
  • 请求地址：https://vod.volcengineapi.com?Action=RetrieveTranscodeResult&Version=2020-08-01

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是RetrieveTranscodeResult接口名称。当前 API 的名称为 RetrieveTranscodeResult。
VersionString是2020-08-01接口版本。当前 API 的版本为 2020-08-01。

Vid

String

是

v0c2dfg7007***212h1nscckh79h0

视频 ID。音视频上传后，获取的方式如下：

  • 通过 GetMediaList 接口查询音视频 Vid，为请求参数 Vid 的值。
  • 如果设置了媒资上传完成的回调事件，会在 FileUploadComplete 中返回 Vid 的值。

ResultType

String

是

inspection

预期获取的结果类型。取值如下：

  • inspection：片源检测结果。
  • category_tags：视频分类结果。

说明

支持多选，则以 , 分隔，例如 inspection,category_tags。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数类型示例值描述
VidStringv0c2dfg7007***212h1nscckh79h0视频 ID，为请求值。
InspectionObject of Inspection-片源检测结果。
CategoryTagsArray of CategoryTags-视频分类结果。若无，则为 []。

Inspection

参数类型示例值描述
QualityObject of Quality-视频检测质量。若无，则为空。
DeLogoArray of DeLogo-水印检测结果。若无，则为 []。

CategoryTags

参数类型示例值描述
TagIdInteger10101标签 ID。
ProbDouble0.022置信度。
TagNameString军事标签名称。
LevelInteger3等级。

ParentInfo

JSON Map

{"01":"转码任务"}

父节点标签信息。格式为 "key":"value"。

  • "key" 为 String 类型，父分类级别。
  • "value" 为 String 类型，父分类内容。

Quality

参数类型示例值描述
VisualObject of Visual-片源检测参数。
VolumeInfoObject of VolumeInfo-音量。
参数类型示例值描述
AnchorWidthInteger671Anchor 基准宽度。
AnchorHeightInteger893Anchor 基准高度。
PosXInteger462水印左上角 X 坐标。
PosYInteger654水印左上角 Y 坐标。
SizeXInteger601水印宽度。
SizeYInteger451水印高度。

Visual

参数类型示例值描述
VQScoreDouble55.56画质检测-VQScore 视频质量评分。
ContrastDouble90.38对比度。
ColorfulnessDouble67.17色彩。
BrightnessDouble134.03亮度。
TextureDouble12.04纹理。
NoiseDouble86噪声。

VolumeInfo

参数类型示例值描述
LoudnessDouble-37.5响度。单位为 LUFS。
PeakDouble0.0912峰值。取值范围为（0, 1.0]， 峰值归一化。
MeanVolumeDouble-40.8均值。单位为 dB。
MaxVolumeDouble-20.8最大值。单位为 dB。

请求示例

GET https://vod.volcengineapi.com?Action=RetrieveTranscodeResult&Version=2020-08-01&Vid=v0c2dfg7007***212h1nscckh79h0&ResultType=inspection

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20220612154735010225243125076AA124",
        "Action": "RetrieveTranscodeResult",
        "Version": "2020-08-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": {
        "Vid": "v0c2dfg7007acafl9212h1nscckh79h0",
        "Inspection": {
            "Quality": {
                "Visual": {
                    "VQScore": 55.56,
                    "Contrast": 90.38,
                    "Colorfulness": 67.17,
                    "Brightness": 134.03,
                    "Texture": 12.04,
                    "Noise": 86
                },
                "VolumeInfo": {
                    "Loudness": -37.5,
                    "Peak": 0.0912,
                    "MeanVolume": -40.8,
                    "MaxVolume": -20.8
                }
            },
            "DeLogo": []
        },
        "CategoryTags": [
            {
                "TagId": 10101,
                "Prob": 0.022,
                "TagName": "军事",
                "Level": 3,
                "ParentInfo": {
                    "1": "社会",
                    "2": "政务"
                }
            },
            {
                "TagId": 10101,
                "Prob": 0.022,
                "TagName": "军事",
                "Level": 3,
                "ParentInfo": {
                    "1": "社会",
                    "2": "政务"
                }
            },
            {
                "TagId": 10101,
                "Prob": 0.022,
                "TagName": "军事",
                "Level": 3,
                "ParentInfo": {
                    "1": "社会",
                    "2": "政务"
                }
            }
        ]
    }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API，此 API 各语言调用的示例代码，请参考如下：