接口描述

调用该接口（GetMediaInfo）可根据媒资 ID 查询媒资详情，如媒资基本信息、转码信息、审核结果信息等。

请求语法

GET  /api/v1/media/<MediaId> HTTP/1.1
Host: api.vod.frontwize.com
Date: <date>
Authorization: <authorization-string>

请求参数

参数 是否必选 参数类型 描述

FileIds

否

String

查询的信息类型。
多个用逗号隔开，为空时表示查询所有信息，不为空时支持同时查询一个或者多个类型的信息，取值如下：

  • baseInfo：媒资基本信息

  • metadata: 媒资原视频信息

  • transcodeInfo：转码结果信息

  • streamingInfo: 自适应转码结果信息

  • thumbnailInfo：截图结果信息

  • reviewInfo：审核结果信息

  • subtitleInfo：字幕信息

响应参数

参数 参数类型 描述

MediaId

String

媒资 ID。

BaseInfo

BaseInfo object

媒资基本信息。

MetaData

MetaData object

视频的元数据信息。 预留。
经过视频解析后产生，包括封装格式、大小、分辨率、码率、帧率。

TranscodeInfos

TranscodeInfo List

转码生成文件信息、转码记录。预留。

说明

仅当转码成功后才能查询到此信息，未转码、正在转码以及转码失败时，无此字段信息。

StreamingInfos

StreamingInfo List

自适应转码结果信息。

BaseInfo

参数 参数类型 描述

Title

String

媒资标题。长度不超过 128 个字节，UTF8 编码。

Description

String

媒资描述。长度不超过 1024 个字节。

CategoryId

Long

媒资分类 ID。

CategoryName

String

媒资分类名称。

CreateTime

String

媒资创建时间。
格式为：yyyymmddhhmmss。必须是与时区无关的UTC时间。

LastModified

String

媒资最近修改时间。
格式为：yyyymmddhhmmss。必须是与时区无关的UTC时间。

MediaType

String

音视频文件类型。
取值如下：

  • 视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV。

  • 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2。

Region

String

所在区域。

PlayUrl

String

原始视频文件的访问地址。

CoverUrl

string

封面地址 URL。

ForbidStatus

string

禁止状态。

取值：

  • normal：正常

  • forbid：禁止

Type

String

文件类型。

匹配集合中的任意元素：

  • Video: 视频文件

  • Audio: 音频文件

  • Image: 图片文件

Source

String

媒资来源。

取值如下：

  • CONSOLE：控制台

  • SDK：SDK 上传

  • 其他或不传：API 接口上传

Duration

int

时长。 单位：毫秒。

MetaData

参数 参数类型 描述

Id

Int

视频 ID。

Codec

String

视频编码格式。
取值：H.264、H.265

Container

String

容器类型，例如 m4a，mp4 等。

Md5

String

视频的 MD5 值。

Duration

Long

视频时长。 单位：毫秒。若视频的原时长为非整数，则该字段值为原时长的向上取整。

Size

Long

视频文件大小。单位：字节。

Width

Long

视频宽度。单位：像素。

  • 编码为H.264的取值范围：[32,3840]之间2的倍数。

  • 编码为H.265的取值范围：[320,3840]之间4的倍数。

Hight

Long

视频高度。单位：像素。

  • 编码为H.264的取值范围：[32,2160]之间2的倍数。

  • 编码为H.265的取值范围：[240,2160]之间4的倍数。

BitRate

Long

视频平均码率。

FrameRate

Long

帧率。默认值：1。单位：帧每秒。

取值如下：

  • FRAMERATE_AUTO = 1,

  • FRAMERATE_10 = 2,

  • FRAMERATE_15 = 3,

  • FRAMERATE_2397 = 4, // 23.97 fps

  • FRAMERATE_24 = 5,

  • FRAMERATE_25 = 6,

  • FRAMERATE_2997 = 7, // 29.97fps

  • FRAMERATE_30 = 8,

  • FRAMERATE_50 = 9,

  • FRAMERATE_60 = 10

Quality

String

清晰度。

取值如下：

  • FULL_HD：超高清

  • HD：高清

  • SD：标清

  • FLUENT：流畅

  • AD：自适应2K4K

AudioChannels

Integer

音频的声道数。

TranscodeInfo

名称 参数类型 描述

PalyUrl

String

转码后的视频播放地址。

Definition

Integer

使用的转码模板 ID。

其余为 MetaData 字段

-

-

StreamingInfo

参数 参数类型 描述

PalyUrl

String

转码后的视频播放地址。

TemplateId

Integer

使用的转码模板 ID。

TemplateName

String

模板名称。

Package

String

打包格式。

DrmType

String

加密类型。

Size

Integer

媒体文件大小。单位：字节。
当媒体文件为 HLS 时，大小是 m3u8 和 ts 文件大小的总和；当媒体文件为 DASH 时，大小是 mpd 和分片文件大小的总和。

FlowNum

Interger

子流数量。

请求示例

GET  /api/v1/media/50591129875255296 HTTP/1.1
Accept: application/json, text/plain, */*
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7
Connection: keep-alive
Host: api.vod.frontwize.com
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Thu, 26 May 2022 02:44:50 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Language,Cookie
Content-Language: zh-cn
Content-Encoding: gzip
x-qvod-request-id: aa08cf7a43f611e5886952542e6ce14b
{
  "MediaId": "50591129875255296",
  "ret_code": 0,
  "BaseInfo": {
    "ForbidStatus": "normal",
    "CategoryName": "",
    "Title": "9294788633300992.mp4",
    "LastModified": "2022-05-20T08:19:42Z",
    "Region": "pek3b",
    "CoverUrl": "-",
    "MediaType": "video/mp4",
    "CategoryId": 0,
    "Source": "Console",
    "Duration": 0,
    "Type": "Video",
    "CreateTime": "2022-05-20T07:32:07Z",
    "PlayUrl": "https://6ajnshtgnbkpnks.vodtest.frontwize.com/vod/50591129875255296.mp4",
    "Description": ""
  },
  "ReviewInfo": "",
  "SubtitleInfo": "",
  "StreamingInfos": null,
  "ThumbnailInfo": "",
  "TranscodeInfos": [
    {
      "Definition": 2,
      "Type": "Video",
      "TemplateType": 1,
      "Container": "HLS",
      "TemplateName": "Video-FLU-H264-HLS",
      "Quality": "SD",
      "FrameRate": 25,
      "Hight": 360,
      "VideoStreamSet": [
        {
          "Width": 640,
          "Codec": "H.264",
          "BitRate": 416815,
          "Hight": 360,
          "FrameRate": 25
        }
      ],
      "Width": 640,
      "AudioStreamSet": [
        {
          "SamplingRate": 44100,
          "Codec": "aac",
          "BitRate": 68481
        }
      ],
      "Codec": "H.264",
      "TemplateId": 2,
      "Duration": 10029,
      "AudioChannels": 2,
      "Size": 608380,
      "BitRate": 416815,
      "Id": 1,
      "PlayUrl": "https://6ajnshtgnbkpnks.vodtest.frontwize.com/vod/50591129875255296.mp4.trans/A4_1543946324942848/video/50591129875255296_640x360_25_400.m3u8",
      "Md5": ""
    }
  ],
  "MetaData": {
    "Container": "mp4",
    "Quality": "HD",
    "FrameRate": 25,
    "Hight": 720,
    "VideoStreamSet": [
      {
        "Width": 1280,
        "Codec": "H.264",
        "BitRate": 1820549,
        "Hight": 720,
        "FrameRate": 25
      }
    ],
    "Width": 1280,
    "AudioStreamSet": [
      {
        "SamplingRate": 44100,
        "Codec": "aac",
        "BitRate": 129336
      }
    ],
    "Codec": "H.264",
    "Duration": 10029,
    "AudioChannels": 2,
    "Size": 2444425,
    "BitRate": 1820549,
    "Id": 0,
    "PlayUrl": "https://6ajnshtgnbkpnks.vodtest.frontwize.com/vod/50591129875255296.mp4",
    "Md5": "-"
  }
}