## 功能描述此接口用于将音频文件转换为指定格式，并存储至指定存储桶。 ## 注意事项 * 当前支持将音频文件格式转换为 mp3、wav、aac、m4a、flac、ac3、opus、oga。 * 音频转码仅支持异步处理（x\-tos\-async\-process 处理方式）。 ## 请求消息样式 ```TypeScript POST /ObjectName?x-tos-async-process HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string x-tos-async-process=audio/convert,f_mp3,ab_128000,abopt_0,ar_0,ac_0,ss_0,t_0&x-tos-save-bucket=dGVzdGJrdA==&x-tos-save-object=dGVzdG9iag== ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |x\-tos\-async\-process |Query |String |是 |\- |代表音频转码请求的特殊标识。 | ## 请求元素 |**名称** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---| |x\-tos\-async\-process |String |是 |audio/convert |媒体处理操作的名称，仅支持取值 `audio/convert`。 | |f |String |是 |mp3 |转码输出格式，取值如下：|\ | | | | ||\ | | | | |* `mp3`|\ | | | | |* `aac`|\ | | | | |* `m4a`|\ | | | | |* `flac`|\ | | | | |* `oga`|\ | | | | |* `ac3`|\ | | | | |* `opus`|\ | | | | |* `wav` | |ab |String |是 |9000 |转码输出码率，取值范围为 [8000, 1000000]，单位 bps。 | |abopt |int |否 |0 |音频码率选项。|\ | | | | |取值：|\ | | | | ||\ | | | | |* `0`（默认值）：始终使用目标音频码率。|\ | | | | |* `1`：拼接列表中存在源音频码率小于 `ab` 参数的值时，使用拼接列表中最小的源音频码率。|\ | | | | |* `2`：拼接列表中存在源音频码率小于 `ab` 参数的值时，返回失败。|\ | | | | ||\ | | | | |:::tip|\ | | | | |该参数需要与 `ab` 参数的值一同设置。|\ | | | | ||\ | | | | |:::| |ar |int |否 |8000 |音频采样率。|\ | | | | |默认与指定的源音频一致，取值：|\ | | | | ||\ | | | | |* `8000`|\ | | | | |* `11025`|\ | | | | |* `12000`|\ | | | | |* `16000`|\ | | | | |* `22050`|\ | | | | |* `24000`|\ | | | | |* `32000`|\ | | | | |* `44100`|\ | | | | |* `48000`|\ | | | | |* `64000`|\ | | | | |* `88200`|\ | | | | |* `96000`|\ | | | | ||\ | | | | |:::tip|\ | | | | |不同格式支持的采样率有所不同，详情请参见[不同音频容器采样率支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#9a1124e1)。|\ | | | | ||\ | | | | |:::| |ac |int |否 |1 |音频声道数。|\ | | | | |默认与指定的源音频一致，取值范围：1 ~ 8。|\ | | | | |:::tip|\ | | | | |不同格式支持的声道数有所不同，详情请参见[不同音频容器参数支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |ss |int |否 |0 |被拼接音频的转码起始时间。|\ | | | | |单位为毫秒，取值：|\ | | | | ||\ | | | | |* `0`（默认值）：从起始位置开始。|\ | | | | |* `大于 0`：从第 `ss` 毫秒开始。 | |t |int |否 |0 |被拼接音频的转码持续时长。|\ | | | | |单位为毫秒，取值：|\ | | | | ||\ | | | | |* `0`（默认值）：持续到结束位置。|\ | | | | |* `大于 0`：持续 `t` 毫秒。 | |af |string |否 |fltp |采样格式。|\ | | | | |取值：|\ | | | | ||\ | | | | |* `fltp`|\ | | | | |* `s16`|\ | | | | |* `s16p`|\ | | | | |* `s32`|\ | | | | |* `s32p`|\ | | | | ||\ | | | | |:::tip|\ | | | | |不同格式支持的采样格式有所不同，详情请参见[不同音频容器参数支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |x\-tos\-save\-bucket |String |否 |dGVzdGJrdA== |存储转码后音频文件的存储桶。如果不设置，则会默认存储在源音频文件的存储桶中。|\ | | | | |:::tip|\ | | | | |当前仅支持同地域存储转码后文件，即存储转码后音频文件的存储桶需要与源音频文件的存储桶位于同一地域。|\ | | | | ||\ | | | | |:::| |x\-tos\-save\-object |String |是 |dGVzdG9iag== |转码后音频文件的名称，该名称需要进行 Base64 编码。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |status |String |OK |状态码。 | ## 请求示例 ```TypeScript POST /example.wav?x-tos-async-process HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string x-tos-async-process=audio/convert,f_mp3,ab_128000&x-tos-save-bucket=bkt&x-tos-save-object=test.mp3 ``` ## 响应示例 ```TypeScript HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 0 { "status": "OK" } ```

对象存储