媒体信息获取接口
更新时间：2025-08-21
查询指定媒体信息
接口描述
用户通过Bucket+BOS Key的URL Encoded的结果获取指定音视频文件的媒体信息。
请求（Request）
-
请求语法：
Http1GET /v{version}/mediainfo?bucket={BOS Bucket}&key={uriComponentEncode(BOS Key)} HTTP/1.1 2accept-encoding: gzip, deflate 3x-bce-date: {utc-date-string} 4host: media.bj.baidubce.com 5accept: */* 6connection: keep-alive 7x-bce-request-id: {bce-request-id} 8content-type: application/json 9authorization: {bce-authorization-string} - 请求头域：无特殊Header参数
- 请求参数：无
-
请求示例：
Http1GET /v3/mediainfo?bucket=samplebucket&key=sampleforderpath%2Fsampleoutput.mp4 HTTP/1.1 2accept-encoding: gzip, deflate 3x-bce-date: 2015-03-24T13:37:10Z 4host: media.bj.baidubce.com 5accept: */* 6connection: keep-alive 7x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750 8content-type: application/json 9authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:37:10Z/1800/host;x-bce-date/3e1bf9f50ae1fca2d704d61567810dde946fff3ca2e455676455a6f5c8cce596
响应（Reponse）
- 响应头域：无特殊Header参数
- 响应参数：
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| bucket | String | 音视频文件所在的BOS的Bucket |
| key | String | 音视频文件的BOS的Key |
| fileSizeInByte | Number | 音视频文件的大小 |
| durationInSecond | Number | 音视频媒体时长 |
| container | String | 音视频文件的容器类型 |
| etag | String | 文件的版本标识（详见BOS接口公共返回头） |
| type | String | 文件类型 |
| video | Object | 视频信息集合 |
| + codec | String | 视频文件的编码规格 |
| + heightInPixel | Number | 视频高度 |
| + widthInPixel | Number | 视频宽度 |
| + bitRateInBps | Number | 视频媒体的码率 |
| + frameRate | Number | 视频媒体的帧率 |
| + rotate | Number | 旋转角度（部分视频包含该参数） |
| + dar | String | 视频显示宽高比，如 "16:9" （部分视频包含该参数） |
| audio | Object | 音频信息集合 |
| + codec | String | 音频文件的编码规格 |
| + channels | Number | 音频文件的声道信息 |
| + sampleRateInHz | Number | 音频文件的采样率 |
| + bitRateInBps | Number | 音频文件的码率 |
-
响应示例：
Http1HTTP/1.1 200 OK 2Transfer-Encoding: chunked 3x-bce-request-id: 3807ce30-5264-45f2-9b52-26b78e24a750 4Cache-Control: no-cache 5Server: BWS 6Date: Tue, 24 Mar 2015 13:37:10 GMT 7Content-Type: application/json;charset=UTF-8 8 9{ 10 "bucket": "samplebucket", 11 "key": "samplefolderpath/sampleoutput.mp4", 12 "fileSize": 102400, 13 "durationInSecond": 60, 14 "container": "mp4", 15 "eTag": "bf407c4ca0dc4f2f7d581ec94ca36876", 16 "type": "video", 17 "video": { 18 "codec": "h264", 19 "heightInPixel": 1024, 20 "widthInPixel": 768, 21 "bitRateInBps": 2500 22 }, 23 "audio": { 24 "codec": "acc", 25 "channels": 2, 26 "sampleRateInHz": 96000, 27 "bitRateInBps": 1100 28 } 29}