拉取上传
更新时间：2025-08-22
该接口用于将一个网络上的音视频文件拉取到VOD。
拉取上传的文件大小限制为不超过5GB。
请求结构
Http
1POST /v2/medias/fetch 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| url | string | 是 | RequestBody参数 | 拉取文件url，长度不超过1024，支持的文件封装格式（url末尾的文件名后缀）：
|
| name | string | 否 | RequestBody参数 | 媒资名称，如果不指定name，将会从url中提取文件名作为生成的媒资名称 |
| coverUrl | string | 否 | RequestBody参数 | 拉取封面图url，长度不超过1024，支持的文件封装格式（url末尾的文件名后缀）：jpg、jpeg、png、gif、bmp、webp |
| categoryId | string | 否 | RequestBody参数 | 分类ID，用于设置媒资分类 |
| workflow | MediaWorkflowTaskInput | 否 | RequestBody参数 | 媒资工作流处理参数，与preset互斥 |
| preset | MediaPresetTaskInput | 否 | RequestBody参数 | 媒资模板处理参数，与workflow互斥 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| taskId | string | 拉取上传的任务ID，可以通过该ID查询拉取上传任务的状态。 |
示例
拉取上传视频
拉取一个视频到VOD，请求如下，其中url为需要拉取的视频文件URL，拉取成功后可以通过响应的taskId查询到拉取任务生成的mediaId，该media的名称将会是demo。
请求内容
Http
1POST /v2/medias/fetch 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 "url": "https://vod.com/demo.mp4?authorization=xxx"
12}返回内容
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 "taskId": "tsk-emdjf2brktngm326"
10}拉取上传视频同时指定封面图
拉取一个视频到VOD，请求如下，其中url为需要拉取的视频文件URL，拉取成功后可以通过响应的taskId查询到拉取任务生成的mediaId，该media的名称将会是demo，会将指定的coverUrl下载为媒资封面图。
请求内容
Http
1POST /v2/medias/fetch 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 "url": "https://vod.com/demo.mp4?authorization=xxx"
12 "coverUrl": "https://vod.com/demo_cover.jpg?authorization=xxx"
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 "taskId": "tsk-emdjf2brktngm326"
10}错误码
详见公共错误返回。