申请媒资封面上传
更新时间：2025-08-22
与媒资上传流程类似，自定义媒资的封面图，也需要通过申请媒资封面上传、上传封面图文件、完成媒资封面上传三步来完成。
通过本接口可以获取封面图上传时的唯一标识uploadKey和上传链接，uploadKey会在完成上传时用于校验文件。
uploadKey有效期为24小时，需在有效期内完成上传封面图文件和完成媒资封面上传请求，否则相应的uploadKey将逾期失效。若已上传封面图文件但未请求完成媒资封面上传，则该封面图文件将会在一天后自动清理。
封面图文件大小限制为不超过5GB。
请求结构
Http
1POST /v2/medias/cover/upload 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>
8
9{
10 // 请求参数
11}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | string | 是 | RequestBody参数 | 封面图名称，用于生成临时上传文件路径 |
| container | string | 是 | RequestBody参数 | 图片封装格式，支持的文件封装格式（文件扩展名）：jpeg、png、gif、jpg、bmp、webp |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| uploadKey | string | 临时上传key |
| uploadUrl | string | 上传预签名链接，使用HTTP PUT上传文件到此地址 |
示例
申请简单上传
请求内容
Http
1POST /v2/medias/cover/upload 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
9
10{
11 "name": "demo",
12 "container": "jpg"
13}返回内容
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 "uploadKey": "tmp/cover/emdkmqy4t0yzihwx8c5f/demo.jpg",
10 "uploadUrl": "https://bj.bcebos.com/v1/vod-ehrtfbngapkevsre/tmp/cover/emdkmqy4t0yzihwx8c5f/demo.jpg?authorization=xxx"
11}获取到上传链接后，可以使用HTTP PUT方法上传文件，以curl方式举例：
Bash
1curl -i -X PUT 'https://bj.bcebos.com/v1/vod-ehrtfbngapkevsre/tmp/cover/emdkmqy4t0yzihwx8c5f/demo.jpg?authorization=xxx' \
2-H 'image/jpeg' \
3--data-binary '@/path/to/demo.jpg'执行以上命令，得到输出类似以下内容，则表示上传成功，下一步可以请求完成媒资封面上传创建媒资。
Plain Text
1HTTP/1.1 100 Continue
2
3HTTP/1.1 200 OK
4Date: Tue, 03 Dec 2024 09:01:49 GMT
5Content-Length: 0
6Connection: keep-alive
7Content-MD5: 4gA7ok7QQ35GUKKsJbcMXA==
8ETag: "e2003ba24ed0437e4650a2ac25b70c5c"
9Server: BceBos
10x-bce-content-crc32: 2470501973
11x-bce-debug-id: n5RKu+pc5wkwcvUuj+mAZrBVusdZ56Znr0jmzNR9J3OsjIWLBnOxbiyuaSsuo7dqtzfVZtfOQLlHkxitMwPzdw==
12x-bce-flow-control-type: -1
13x-bce-is-transition: false
14x-bce-request-id: 29235247-d5a8-45ca-8381-746f25c549f8错误码
详见公共错误返回。