## 功能描述提交一个音视频转码任务。 ## 注意事项仅 mp4 格式的视频文件支持使用 CreateTranscodeJob 接口。 ## 请求消息样式 ```Plain Text POST /?job_type=Transcode&media_jobs HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Input": { "Object": "sample.mp4" }, "TranscodeConfig": { "Transcode": { "TimeInterval": { "Start": 0, "Duration": 10000 }, "Container": { "Format": "mp4", "ClipConfig": { "Duration": 0, } }, "Video": { "Codec": "h264", "Width": 480, "Height": 480, "Crf": 1, "PixFmt": "yuv420p", "BitRate": 0, "Fps": 0, "Remove": false }, "Audio": { "Codec": "mp3", "SampleRate": 44100, "BitRate": 0, "Channels": 2, "SampleFormat": "fltp", "Remove": false, } } }, "Output": { "Region": "cn-beijing", "Bucket": "testbkt", "Object": "output.mp4" } } ``` ## 请求参数和消息头 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |media_jobs |Query |String |是 |\\- |代表媒体任务的请求特殊标识。 | |job_type |Query |String |是 |Transcode |任务类型，音视频转码场景下取值仅为 `Transcode`。 | ## 请求元素 |**名称** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---| |Input |Container |是 |\\- |源文件。 | |Object |String |是 |data.mp4 |待转码的源音视频文件名称。|\ | | | | |父节点：Input。 | |TranscodeConfig |Container |否 |\\- |音视频转码的具体配置。 | |Transcode |Container |否 |\\- |音视频转码的具体配置。|\ | | | | |父节点：TranscodeConfig。 | |Callback |String | 否 |https://myapp.com/callback |异步任务 HTTP Post 回调地址，回调请求body结构体定义与 QueryMediaJob 的响应消息body一致 | |TimeInterval |Container |否 |\\- |指定音视频需要转码的时段。|\ | | | | |父节点：Transcode。 | |Start |Integer |否 |0 |音视频开始时间，单位毫秒。|\ | | | | |父节点：TimeInterval。 | |Duration |Integer |否 |1000 |音视频持续时间，单位毫秒。|\ | | | | |:::tip|\ | | | | |如果不设置` Start` 和 `Duration`，则会转码整个视频。|\ | | | | |:::|\ | | | | |父节点：TimeInterval。 | |Container |Container |是 |\\- |音视频封装格式。|\ | | | | |父节点：Transcode。 | |Format |String |是 |ts |转码后音视频文件的封装格式。取值如下：|\ | | | | ||\ | | | | |* `mp4`|\ | | | | |* `ts`|\ | | | | |* `hls`|\ | | | | |* `mp3`|\ | | | | |* `aac`|\ | | | | |* `flac`|\ | | | | |* `m4a`|\ | | | | |* `oga`|\ | | | | |* `wav`|\ | | | | |* `ac3`|\ | | | | |* `opus`|\ | | | | ||\ | | | | |父节点：Container。 | |ClipConfig |Container |否 |\\- |分片配置，当 `Format` 为 `hls` 时有效。|\ | | | | |父节点：Container | |Duration |Integer |否 |5000 |分片时长，单位毫秒。|\ | | | | |父节点：ClipConfig。 | |Video |Container |否 |\\- |视频编码参数。|\ | | | | |父节点：Transcode。 | |Codec |String |否 |h264 |视频流编码格式，取值如下：|\ | | | | ||\ | | | | |* `h264`|\ | | | | |* `h265`|\ | | | | ||\ | | | | |父节点：Video。 | |Width |Integer |否 |4096 |视频文件的宽度，必须为偶数，单位 px，取值范围为 [128，4096]。|\ | | | | |:::tip|\ | | | | ||\ | | | | |* 如果只设置 `Width` ，未设置`Height`，将按照视频原始比例计算视频文件的高度。|\ | | | | |* 如果只设置 `Height` ，未设置`Width`，将按照视频原始比例计算视频文件的宽度。|\ | | | | ||\ | | | | |:::|\ | | | | |父节点：Video。 | |Height |Integer |否 |1024 |视频文件的高度，必须为偶数，单位为 px，取值范围 [128，4096]。|\ | | | | |父节点：Video。 | |Crf |Integer |否 |25 |视频文件的码率控制因子。|\ | | | | |父节点：Video。 | |PixFmt |String |否 |yuv420p |视频像素格式，取值为 `yuv420p`。|\ | | | | |父节点：Video | |BitRate |Integer |否 |10000 |视频输出文件的码率，值范围 [10000, 50000000]。|\ | | | | |父节点：Video。 | |Fps |Integer |否 |24 |视频帧率，值范围 [0, 60]。|\ | | | | |父节点：Video | |Remove |Boolean |否 |false |是否删除视频流，取值 `true` 或 `false`。|\ | | | | |父节点：Video。 | |Audio |Container |否 |\\- |音频编码参数。|\ | | | | |父节点：Transcode。 | |Codec |String |否 |mp3 |音频流编码格式，取值如下：|\ | | | | ||\ | | | | |* `mp3`|\ | | | | |* `aac`|\ | | | | |* `flac`|\ | | | | |* `Vorbis`|\ | | | | |* `ac3`|\ | | | | |* `opus`|\ | | | | |* `pcm_s16le`|\ | | | | ||\ | | | | |:::tip|\ | | | | |不同容器格式支持的音频编码格式有所不同，详情请参见[不同容器的音频编码格式支持情况](/docs/6349/2129095#cd717e7f)。|\ | | | | ||\ | | | | |:::| |SampleRate |Integer |否 |44100 |音频采样率。|\ | | | | |默认与指定的源音频一致，取值：|\ | | | | ||\ | | | | |* `8000`|\ | | | | |* `11025`|\ | | | | |* `12000`|\ | | | | |* `16000`|\ | | | | |* `22050`|\ | | | | |* `24000`|\ | | | | |* `32000`|\ | | | | |* `44100`|\ | | | | |* `48000`|\ | | | | |* `64000`|\ | | | | |* `88200`|\ | | | | |* `96000`|\ | | | | ||\ | | | | |:::tip|\ | | | | |不同格式支持的采样率有所不同，详情请参见[不同音频容器采样率支持情况](/docs/6349/2038064#9a1124e1)。|\ | | | | ||\ | | | | |:::| |BitRate |Integer |否 |8000 |音频比特率（码率）。|\ | | | | |单位为比特/秒（bps），取值范围：1000~10000000。 | |Channels |Integer |否 |2 |音频声道数。|\ | | | | |默认与指定的源音频一致，取值范围：1~8。|\ | | | | |:::tip|\ | | | | |不同格式支持的声道数有所不同，详情请参见[不同音频容器参数支持情况](/docs/6349/2038064#6b82ba91)。|\ | | | | ||\ | | | | |:::| |SampleFormat |String |否 |fltp |采样格式。|\ | | | | |取值：|\ | | | | ||\ | | | | |* `fltp`|\ | | | | |* `s16`|\ | | | | |* `s16p`|\ | | | | |* `s32`|\ | | | | |* `s32p`|\ | | | | ||\ | | | | |:::tip|\ | | | | |不同格式支持的采样格式有所不同，详情请参见[不同音频容器参数支持情况](/docs/6349/2038064#6b82ba91)。|\ | | | | ||\ | | | | |:::| |Remove |Boolean |否 |false |是否删除音频流，取值 `true` 或 `false`。|\ | | | | |父节点：Audio | |Output |Container |是 |\\- |转码后视频文件的存储配置。 | |Region |String |是 |cn\-beijing |转码后视频文件的存储地域。|\ | | | | |父节点：Output。 | |Bucket |String |是 |test |存储转码后视频文件的存储桶。|\ | | | | |父节点：Output。 | |Object |String |是 |data.ts |转码后视频文件的名称。|\ | | | | |父节点：Output。 | ### 不同容器的音频编码格式支持情况 |**容器格式** |**支持的音频编码格式** | |---|---| |mp4 |mp3/aac | |ts |mp3/aac | |hls |mp3/aac | |mp3 |mp3 | |aac |aac | |flac |flac | |oga |Vorbis | |ac3 |ac3 | |opus |opus | |wav |pcm_s16le | ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## **响应元素** |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |Code |String |OK |状态码。 | |Message |String |Success |请求状态信息。 | |JobId |String |1852a9645b553232cdf10001fd35952a4b08 |视频转码任务 ID。 | ## 请求示例 ```JSON POST /?job_type=Transcode&media_jobs HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Input": { "Object": "sample.mp4" }, "TranscodeConfig": { "Transcode": { "TimeInterval": { "Start": 0, "Duration": 10000 }, "Container": { "Format": "mp4" }, "Video": { "Codec": "h264", "Width": 480, "Height": 480, "Crf": 1 } } }, "Output": { "Region": "cn-beijing", "Bucket": "testbkt", "Object": "output.mp4" } } ``` ## 响应示例 ```Plain Text HTTP/1.1 204 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 { "Code": "OK", "Message": "Success", "JobId": "1852a9645b553232cdf10001fd35952a4b08" } ```

对象存储