## 功能描述此接口通过 Job 方式创建音频转码任务。提交后异步执行音频转码作业，并返回任务 ID（`JobId`）。后续可通过该 `JobId` 查询异步任务的执行状态与结果。 ## 注意事项 * 当前仅支持将音频文件格式转换为 `mp3`、`wav`、`aac`、`m4a`、`flac`、`ac3`、`opus`、`og`。 * 通过子账号使用时，需要授予当前桶的 `PostDataProcess` 权限。 ## 请求消息样式 ```Plain Text POST /?job_type=AudioConvert&media_jobs HTTP/1.1 Host: .tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: Content-Type: application/json { "Input": { "Object": "sample.wav" }, "AudioConvertConfig": { "ContainerFormat": "mp3", "TimeInterval": { "Start": 0, "Duration": 0 }, "BitRate": 8000, "BitRateOpt": 0, "SampleFormat": "", "SampleRate": 48000, "Channels": 2 }, "Output": { "Region": "cn-beijing", "Bucket": "test-bucket", "Object": "output.mp3" } } ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 |名称 |位置 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---|---| |media_jobs |Query |String |是 |\- |代表媒体任务的请求特殊标识。 | |job_type |Query |String |是 |AudioConvert |任务类型，音频转码场景下取值仅为 `AudioConvert`。 | ## 请求元素 |名称 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---| |Input |String |是 |\- |源文件。 | |Object |String |是 |sample.wav |待转码的源音频文件。

父节点：`Input` | |AudioConvertConfig |String |是 |\- |音频转码任务的转码配置。 | |ContainerFormat |String |是 |aac |音频转码输出格式，取值如下：

* `mp3`

* `aac`

* `m4a`

* `flac`

* `oga`

* `ac3`

* `opus`

* `wav`

父节点：`AudioConvertConfig` | |TimeInterval |String |否 |\- |截取源音频的时间区间。

父节点：`AudioConvertConfig` | |BitRate |String |是 |9000 |转码输出码率，单位 bps/s，取值范围为 [8000, 1000000]，值为 `0` 时表示沿用源音频码率。

父节点：`AudioConvertConfig` | |BitRateOpt |Integer |否 |0 |音频码率选项。取值如下：

* `0`（默认值）：始终使用目标音频码率。

* `1`：拼接列表中存在源音频码率小于 `ab` 参数的值时，使用拼接列表中最小的源音频码率。

* `2`：拼接列表中存在源音频码率小于 `ab` 参数的值时，返回失败。

说明

该参数需要与 BitRate 参参数的值一同设置。父节点：AudioConvertConfig

| |SampleRate |Integer |否 |8000 |输出音频采样率，单位为 Hz，默认与指定的源音频一致。

取值为 `0` 或对应 `ContainerFormat` 支持的采样率，值为 `0` 时表示沿用源音频采样率。取值如下所示：

* `8000`

* `11025`

* `12000`

* `1600`

* `22050`

* `24000`

* `32000`

* `44100`

* `48000`

* `64000`

* `88200`

* `96000`

说明

不同格式支持的采样率有所不同，详情请参见不同音频容器采样率支持情况。父节点：AudioConvertConfig

说明

不同格式支持的声道数有所不同，详情请参见不同音频容器参数支持情况。父节点：AudioConvertConfig

说明

不同格式支持的采样格式有所不同，详情请参见不同音频容器参数支持情况。

说明

当前仅支持同地域存储转码后文件，即存储转码后音频文件的存储桶需要与源音频文件的存储桶位于同一地域。

父节点：`Output` | |Object |String |是 |dGVzdG9iag== |转码后音频文件的名称，该名称需要进行 Base64 编码。

父节点：`Output` | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 ## 响应元素 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |Status |String |OK |状态码。 | ## 请求示例 **创建音频转码任务** ```TypeScript POST /?job_type=AudioConvert&media_jobs HTTP/1.1 Host: .tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: Content-Type: application/json { "Input": { "Object": "sample.wav" }, "AudioConvertConfig": { "ContainerFormat": "mp3", "TimeInterval": { "Start": 0, "Duration": 0 }, "BitRate": 8000, "BitRateOpt": 0, "SampleFormat": "", "SampleRate": 48000, "Channels": 2 }, "Output": { "Region": "cn-beijing", "Bucket": "test-bucket", "Object": "output.mp3" } } ``` **查询音频转码任务** ```Plain Text GET /?job_type=AudioConvert&job_id=18b70c01f053918ed0ef000137b6e9cc7042 HTTP/1.1 Host: .tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: ``` ## 响应示例 **创建音频转码任务** ```Plain Text HTTP/1.1 200 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": "18b70c01f053918ed0ef000137b6e9cc7042" } ``` **查询音频转码任务** ```Plain Text HTTP/1.1 200 OK Content-Type: application/json { "JobID": "18b70c01f053918ed0ef000137b6e9cc7042", "State": "Success", "CreateTime": "2026-06-08T15:56:20+08:00", "StartTime": "2026-06-08T15:56:20+08:00", "EndTime": "2026-06-08T15:56:20+08:00", "Error": "", "Code": 0, "Message": "", "Input": { "Object": "sample.wav" }, "AudioConvertConfig": { "ContainerFormat": "mp3", "TimeInterval": { "Start": 0, "Duration": 0 }, "BitRate": 8000, "BitRateOpt": 0, "SampleRate": 48000, "Channels": 2, "SampleFormat": "" }, "Output": { "Region": "cn-qingdao-test", "Bucket": "data-process-bench", "Object": "output.mp3" }, "Tag": "AudioConvert" } ```

对象存储