查询媒资详情
更新时间:2024-12-17
本接口用于查询媒资详细信息,结果包含媒资多种信息,包括:
- 媒资基础信息、源文件meta信息
- 转码输出结果
- 抽帧输出结果
- 字幕输出结果
- 审核输出结果
- 分析输出结果
请求结构
Http
1GET /v2/medias/{mediaId} HTTP/1.1
2connection: keep-alive
3host: vod.bj.baidubce.com
4content-type: application/json
5x-bce-request-id: <bce-request-id>
6x-bce-date: <utc-date-string>
7authorization: <bce-authorization-string>
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
mediaId | string | 是 | Path参数 | 媒资ID |
返回头域
除公共头域,无其它特殊头域。
返回参数
参考 MediaDetail 结构定义。
示例
查询指定媒资
请求内容
Http
1GET /v2/medias/mda-ek1knpprazeyv1gn HTTP/1.1
2host: vod.bj.baidubce.com
3accept: */*
4connection: keep-alive
5content-type: application/json
6x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
7x-bce-date: 2024-03-24T13:08:44Z
8authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2024-03-24T13:08:44Z/1800/host;x-bce-date/7e21c9cf1e4e2cc6921a407a388fe98df122c53b9f509043d841be76eb09a1f9
返回内容
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 6bae5cb3-97d1-4b1a-b8b6-0ad577c1d481
4Cache-Control: no-cache
5Date: Tue, 24 Mar 2024 13:08:44 GMT
6Content-Type: application/json;charset=UTF-8
7
8{
9 "mediaId": "mda-ek1knpprazeyv1gn",
10 "name": "demo",
11 "description": "",
12 "mediaType": "video",
13 "banStatus": "NORMAL",
14 "createTime": "2024-11-26T02:08:27Z",
15 "tags": [
16 "short_video"
17 ],
18 "categoryId": "ek1knxq4san4617d8bux",
19 "source": {
20 "sourceType": "UPLOAD",
21 "sourceUrl": "https://vod.com/mda-ek1knpprazeyv1gn/_src/mda-ek1knpprazeyv1gn.mp4",
22 "coverUrl": "https://vod.com/mda-ek1knpprazeyv1gn/_output/ejisy3kbvfiwejzsemx9/mda-ek1knpprazeyv1gn00000000.jpg"
23 },
24 "sourceMetadata": {
25 "fileSizeInByte": 779449828,
26 "type": "video",
27 "container": "mov,mp4,m4a,3gp,3g2,mj2",
28 "durationInSecond": 139,
29 "durationInMillisecond": 138670,
30 "video": {
31 "codec": "h264",
32 "heightInPixel": 2160,
33 "widthInPixel": 3840,
34 "bitRateInBps": 44765683,
35 "frameRate": 60.0,
36 "dar": "16:9"
37 },
38 "audio": {
39 "codec": "aac",
40 "channels": 2,
41 "sampleRateInHz": 44100,
42 "bitRateInBps": 198048
43 },
44 "etag": "-8f8fe07c61ceca0b8f851c3f5b51a122"
45 },
46 "transcodeOutputs": [
47 {
48 "id": "ejisxn9bmajvi36kxwnz",
49 "url": "https://vod.com/mda-ek1knpprazeyv1gn/_output/ejisxn9bmajvi36kxwnz/mda-ek1knpprazeyv1gn.mp4",
50 "meta": {
51 "video": {
52 "durationInSeconds": 139,
53 "durationInMilliSeconds": 138680,
54 "sizeInKiloByte": 14428.041992,
55 "widthInPixel": 1920,
56 "heightInPixel": 1080,
57 "frameRate": 25,
58 "gopAlign": true,
59 "mp4MoovSize": 72258
60 },
61 "audio": {
62 "sampleRateInHz": 44100,
63 "channels": 2
64 }
65 }
66 },
67 {
68 "id": "ejisewhutbi59hf21wnd",
69 "url": "https://vod.com/mda-ek1knpprazeyv1gn/_output/ejisewhutbi59hf21wnd/mda-ek1knpprazeyv1gn.mp4",
70 "meta": {
71 "video": {
72 "durationInSeconds": 139,
73 "durationInMilliSeconds": 138700,
74 "sizeInKiloByte": 16769.270508,
75 "widthInPixel": 2048,
76 "heightInPixel": 1152,
77 "frameRate": 30,
78 "gopAlign": true,
79 "mp4MoovSize": 80539
80 },
81 "audio": {
82 "sampleRateInHz": 44100,
83 "channels": 2
84 }
85 }
86 },
87 {
88 "id": "ejis65at3r7a1ecpd3pg",
89 "url": "https://vod.com/mda-ek1knpprazeyv1gn/_output/ejis65at3r7a1ecpd3pg/mda-ek1knpprazeyv1gn.mp4",
90 "meta": {
91 "video": {
92 "durationInSeconds": 139,
93 "durationInMilliSeconds": 138700,
94 "sizeInKiloByte": 44282.558594,
95 "widthInPixel": 3840,
96 "heightInPixel": 2160,
97 "frameRate": 30,
98 "gopAlign": true,
99 "mp4MoovSize": 80475
100 },
101 "audio": {
102 "sampleRateInHz": 44100,
103 "channels": 2
104 }
105 }
106 }
107 ],
108 "thumbnailOutputs": [
109 {
110 "id": "ejisy3kbvfiwejzsemx9",
111 "urls": [
112 "https://vod.com/mda-ek1knpprazeyv1gn/_output/ejisy3kbvfiwejzsemx9/mda-ek1knpprazeyv1gn00000000.jpg"
113 ],
114 }
115 ]
116}
错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
错误码 | 错误信息 | HTTP状态码 | 描述 |
---|---|---|---|
MediaNotFound | Media not found with mda-xxx | 404 Not Found | 没有找到对应的媒资 |