媒资通用处理
更新时间：2025-08-22
本接口用于对VOD的媒资发起处理任务，功能包括：
-
指定工作流发起媒资处理，工作流节点可以包括：
- 转码
- 抽帧
- 视频黑边检测
- 字幕提取
- 视频内容分析（提取人物、场景等标签、分类）
- 视频内容审核（涉黄、暴恐、涉政、违禁、广告等）
-
指定转码模板发起转码
- 转码时可以指定明水印、数字水印
- 指定抽帧模板发起抽帧
发起处理任务后，VOD会生成一个相关的任务ID，可通过任务ID查询任务详情API获取任务的执行状态。
请求结构
Http
1POST /v2/medias/process 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}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| mediaId | string | 是 | RequestBody参数 | 媒资ID |
| workflow | MediaWorkflowTaskInput | 否 | RequestBody参数 | 工作流处理任务输入，与preset参数二选一 |
| preset | MediaPresetTaskInput | 否 | RequestBody参数 | 转码处理任务输入，与workflow参数二选一 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| taskId | string | 任务ID |
示例
使用工作流发起处理任务
ejisxn9bmajvi36kxwnz 为预先配置好的工作流ID。
请求内容
Http
1POST /v2/medias/process 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 "mediaId": "mda-ek1knpprazeyv1gn",
12 "workflow": {
13 "workflowId": "ejisxn9bmajvi36kxwnz"
14 }
15}返回内容
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}使用转码模板发起转码和抽帧，并在转码时指定水印
ejisxn9bmajvi36kxwnz 为转码模板ID，ejisy3kbvfiwejzsemx9 为抽帧模板ID，ejis5xgb8mh9g8w69zxp 为水印ID。
请求内容
Http
1POST /v2/medias/process 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 "mediaId": "mda-ek1knpprazeyv1gn",
12 "preset": {
13 "presetIds": [
14 "ejisxn9bmajvi36kxwnz",
15 "ejisy3kbvfiwejzsemx9"
16 ],
17 "watermarkIds": [
18 "ejis5xgb8mh9g8w69zxp"
19 ]
20 }
21}返回内容
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}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 错误信息 | HTTP状态码 | 描述 |
|---|---|---|---|
| MediaNotFound | Media not found with mda-xxx | 404 Not Found | 没有找到对应的媒资 |
| MediaProcessParamError | Media xxx process param error, workflow or preset needs to be specified | 400 Bad Request | 没有指定工作流或转码模板参数，二者至少需要指定一个 |
| MediaProcessParamError | Media xxx process param error, unable to find an existing preset using the presetIds parameter | 400 Bad Request | 没有找到对应的模板ID |
| MediaBanned | Media %s is banned | 403 Forbidden | 媒资已经被封禁，不能处理 |
| MediaSourceFileNotFound | Media source file not found with mediaId/sessionKey : xxx | 404 Not Found | 没有找到对应的源文件 |
| NoSuchWorkflow | no such workflow : xxx | 404 Not Found | 没有找到对应的工作流 |