logologo
售前咨询
点播云
产品简介
购买指南
快速入门
控制台指南
服务端API
调用方式
媒资上传
媒资管理
媒体处理
事件通知
点播CDN
数据统计
空间管理
回调配置
SDK文档
相关协议
文档中心服务端API媒资管理获取媒资信息

获取媒资信息


1. 请求参数

字段

类型

是否必填

示例

描述

Action

String

DescribeMediaInfo

公共参数,获取媒资信息,取值:DescribeMediaInfo

MediaId

String

aa2e88a7e95db9f7

视频媒资 ID

SpaceName

String

default_space

默认为账号下的默认空间


2. 返回参数

字段

类型

描述

MediaId

String

视频ID

BasicInfo

BasicInfo

媒资基础信息

SourceInfo

SourceInfo

原文件信息

TranscodeInfos

Array of TranscodeInfo

转码文件信息列表

SourceInfo

字段

类型

描述

URLPath

String

文件相对路径

Format

String

文件格式

Duration

Double

文件时长,单位秒

CreateTime

String

创建时间,YYYY-MM-DDThh:mm:ssZ

Width

Integer

视频宽,单位:px

Height

Integer

视频高,单位:px

Fps

Double

帧率,单位:Hz

Bitrate

Integer

文件码率,单位:Kbps

FileSize

Long

文件大小,单位:byte

VideoStreams

Array of VideoStream

视频流列表信息

AudioStreams

Array of AudioStream

音频流列表信息

HdrType

String

Hdr类型。

枚举值:

• SDR

• HDR10

• HDR10+

• Dolby Vision

• HLG

• SDR+

BasicInfo

字段

类型

描述

MediaId

String

媒资id

Title

String

标题

Description

String

描述

CoverUrl

Double

封面图预览地址

CreateTime

String

创建时间,YYYY-MM-DDThh:mm:ssZ

UpdateTime

String

更新时间,YYYY-MM-DDThh:mm:ssZ

SouceInfo

字段

类型

描述

PlayUrl

String

源文件的播放地址

URLPath

String

文件相对路径

Format

String

文件格式

Duration

Double

文件时长,单位秒

CreateTime

String

创建时间,YYYY-MM-DDThh:mm:ssZ

Width

Integer

视频宽,单位:px

Height

Integer

视频高,单位:px

Fps

Double

帧率,单位:Hz

FileSize

Long

文件大小,单位:byte

VideoMaxBitrate

Integer

峰值码率,单位:Kbps

VideoStreams

Array of VideoStream

视频流列表信息

AudioStreams

Array of AudioStream

音频流列表信息

HdrType

String

Hdr类型。

枚举值:

• SDR

• HDR10

• HDR10+

• Dolby Vision

• HLG

• SDR+

Bitrate

Integer

文件码率,单位:Kbps

TranscodeInfo

字段

类型

描述

TranscodeTemplateId

String

转码模板Id

PlayUrl

String

源文件的播放地址

URLPath

String

文件相对路径

Format

String

文件格式

Duration

Double

文件时长,单位秒

CreateTime

String

创建时间,YYYY-MM-DDThh:mm:ssZ

Width

Integer

视频宽,单位:px

Height

Integer

视频高,单位:px

Fps

Double

帧率,单位:Hz

FileSize

Long

文件大小,单位:byte

VideoMaxBitrate

Integer

峰值码率,单位:Kbps

VideoStreams

Array of VideoStream

视频流列表信息

AudioStreams

Array of AudioStream

音频流列表信息

HdrType

String

Hdr类型。

枚举值:

• SDR

• HDR10

• HDR10+

• Dolby Vision

• HLG

• SDR+

Bitrate

Integer

文件码率,单位:Kbps

VideoStream

字段

类型

描述

Duration

Double

视频流时长,单位秒

Width

Integer

视频宽,单位:px

Height

Integer

视频高,单位:px

Fps

Double

帧率,单位:fps

Bitrate

Integer

码率,单位:Kbps

Rotate

String

旋转角度

枚举值:

• 0

• 90

• 180

• 270

Codec

String

编码类型

AudioStream

字段

类型

描述

Duration

Double

音频流时长,单位秒

Bitrate

Integer

码率,单位:Kbps

Channels

Integer

声道

SampleRate

Integer

采样率,单位Hz

Codec

String

编码类型


3. 示例

3.1 请求示例

curl -X POST 'https://vod.streamlakeapi.com/?Action=DescribeMediaInfo' \
-H 'Content-Type: application/json' \
-d '{"MediaId":"d9c41b6883efb2c2"}'


3.2 返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
{
"ResponseData": {
"MediaId": "a8a6ef1791e276de",
"PrimaryKey": "demo_test_test_1637762121844",
"SourceInfo": {
"URLPath": "/mediacloud/demo_test/demo_test_video/a8a6ef1791e276de-89fc3ead6d58f6ed0c9e7c836629f971",
"PlayUrl": "https://testlzx120701.streamlake.com/0kO84KQJMbfboYsu0Z7vPmKcIbn71nd7XBZKNeMl3Og",
"Format": "mpeg_ts",
"Duration": 30.1134,
"CreateTime": "2021-11-24T13:55:27.500Z",
"Width": 3840,
"Height": 2160,
"Fps": 23.976023976023978,
"Bitrate": 10948,
"FileSize": 41213360,
"VideoStreams": [
{
"Duration": 29.237533,
"Width": 3840,
"Height": 2160,
"Fps": 23.976023976023978,
"Bitrate": 10948,
"Rotate": "0",
"Codec": "hevc"
}
],
"AudioStreams": [
{
"Duration": 29.9975,
"Bitrate": 0,
"Channels": 8,
"SampleRate": 48000,
"Codec": "truehd"
}
],
"HdrType": "hdr"
},
"TranscodeInfos": [
{
"TranscodeTemplateId": "nothdr_540p_h264_hls_audio_enhance",
"URLPath": "/mediacloud/demo_test/demo_test_video/a8a6ef1791e276de-541bc00ac989a1155a43cdc96777e6a2-nothdr_540p_h264_hls_audio_enhance.m3u8",
"PlayUrl": "https://testlzx120701.streamlake.com/0kO84KQJMbfboYsu0Z7vPmKcIbn71nd7XBZKNeMl3Og",
"Format": "m3u8",
"Duration": 30.156,
"CreateTime": "2021-11-24T13:58:56.574Z",
"Width": 960,
"Height": 540,
"Fps": 23.976023976023978,
"Bitrate": 156,
"FileSize": 591406,
"VideoMaxBitrate": 2000,
"VideoStreams": [
{
"Duration": 30.155125,
"Width": 960,
"Height": 540,
"Fps": 23.976023976023978,
"Bitrate": 87,
"Rotate": "0",
"Codec": "h264"
}
],
"AudioStreams": [
{
"Duration": 30.037,
"Bitrate": 64,
"Channels": 2,
"SampleRate": 48000,
"Codec": "aac"
}
],
"HdrType": "sdr"
},
{
"TranscodeTemplateId": "hls_ts_h264_4k_audio_enhance",
"URLPath": "/mediacloud/demo_test/demo_test_video/a8a6ef1791e276de-25b9551279985585edddb34fd73cf185-hls_ts_h264_4k_audio_enhance.m3u8",
"Format": "m3u8",
"Duration": 30.156,
"CreateTime": "2021-11-24T14:03:26.765Z",
"Width": 3840,
"Height": 2160,
"Fps": 23.976023976023978,
"Bitrate": 734,
"FileSize": 2767131,
"VideoMaxBitrate": 8000,
"VideoStreams": [
{
"Duration": 30.155125,
"Width": 3840,
"Height": 2160,
"Fps": 23.976023976023978,
"Bitrate": 473,
"Rotate": "0",
"Codec": "hevc"
}
],
"AudioStreams": [
{
"Duration": 30.037,
"Bitrate": 256,
"Channels": 2,
"SampleRate": 48000,
"Codec": "aac"
}
],
"HdrType": "hdr"
}
]
},
"ResponseMeta": {
"RequestId": "rBEkQWG66e4AAAAAAAAAAA",
"ErrorCode": "",
"ErrorMessage": ""
}
}


4. 错误码

ErrorCode

ErrorMessage

说明

状态码

InvalidArgument

Video {MediaId/PrimaryKey} not found

MediaId对应的媒体文件不存在

400


上一篇:URL拉取上传媒资下一篇:创建转码模板
该篇文档内容是否对您有帮助?
有帮助没帮助