字段	类型	是否必填	示例	描述
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拉取上传媒资下一篇：创建转码模板

该篇文档内容是否对您有帮助？

有帮助没帮助

关于我们

支持与服务

法律支持

联系我们

友情链接