对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储API 参考存储桶数据处理媒体处理音频转码CreateAudioConvertJob
复制全文
下载 pdfCreateAudioConvertJob
文档反馈
问问助手功能描述
此接口通过 Job 方式创建音频转码任务。提交后异步执行音频转码作业，并返回任务 ID（JobId）。后续可通过该 JobId 查询异步任务的执行状态与结果。
注意事项
- 当前仅支持将音频文件格式转换为 mp3、wav、aac、m4a、flac、ac3、opus、oga。
- 使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateMediaProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。
请求消息样式
POST /?job_type=AudioConvert&media_jobs HTTP/1.1
Host: <bucket_name>.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: <authorization_string>
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"
}
}
请求参数和消息头
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
media_jobs | Query | String | 是 | - | 代表媒体任务的请求特殊标识。 |
job_type | Query | String | 是 | AudioConvert | 任务类型，音频转码场景下取值仅为 AudioConvert。 |
请求元素
名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
Input | - | 是 | - | 源文件。 |
Object | String | 是 | sample.wav | 待转码的源音频文件。 父节点：Input |
AudioConvertConfig | - | 是 | - | 音频转码任务的转码配置。 |
ContainerFormat | String | 是 | aac | 音频转码输出格式，取值如下：
父节点：AudioConvertConfig |
TimeInterval | - | 否 | - | 截取源音频的时间区间。 父节点：AudioConvertConfig |
BitRate | Integer | 否 | 9000 | 转码输出码率，单位 bps，取值范围为 [8000, 1000000]， 值为 0 时表示沿用源音频码率。 父节点：AudioConvertConfig |
BitRateOpt | Integer | 否 | 0 | 音频码率选项。取值如下：
说明 该参数需要与 BitRate 参数的值一同设置。父节点：AudioConvertConfig |
SampleRate | Integer | 否 | 8000 | 输出音频采样率，单位为 Hz，默认与指定的源音频一致。 取值为 0 或对应 ContainerFormat 支持的采样率，值为 0 时表示沿用源音频采样率。 取值如下所示：
说明 |
Channels | Integer | 否 | 1 | 音频声道数，默认与指定的源音频一致，取值范围：1 ~ 8。 说明 |
Start | Integer | 否 | 0 | 音频转码的起始时间。单位为毫秒，取值如下：
父节点：TimeInterval |
Duration | Integer | 否 | 0 | 音频转码的持续时长。单位为毫秒，取值如下：
父节点：TimeInterval |
SampleFormat | String | 否 | fltp | |
Output | - | 是 | - | 输出音频的存储配置。 |
Region | String | 是 | cn-beijing | 输出音频的存储地域。 父节点：Output |
Bucket | String | 否 | test-bucket | 存储转码后音频文件的存储桶。如果不设置，则会默认存储在源音频文件的存储桶中。 说明 当前仅支持同地域存储转码后文件，即存储转码后音频文件的存储桶需要与源音频文件的存储桶位于同一地域。 父节点：Output |
Object | String | 是 | output.mp3 | 转码后音频文件的名称，该名称后缀必须与 ContainerFormat 保持一致。 父节点：Output |
响应消息头
响应元素
名称 | 参数类型 | 示例值 | 说明 |
名称 | 参数类型 | 示例值 | 说明 |
Code | String | OK | 状态码。
|
Message | String | Success | 请求状态信息。 |
JobId | String | 18b70c01f053918ed0ef000137b6******** | 音频转码任务 ID。 |
请求示例
创建音频转码任务
POST /?job_type=AudioConvert&media_jobs HTTP/1.1
Host: <bucket_name>.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: <authorization_string>
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"
}
}
查询音频转码任务
GET /?job_type=AudioConvert&job_id=18b70c01f053918ed0ef000137b6e9cc7042 HTTP/1.1
Host: <bucket_name>.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: <authorization_string>
响应示例
创建音频转码任务
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": "18b70c01f053918ed0ef000137b6********"
}
查询音频转码任务
HTTP/1.1 200 OK
Content-Type: application/json
{
"JobID": "18b70c01f053918ed0ef000137b6********",
"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"
}
最近更新时间：2026.09.16 11:14:20
这个页面对您有帮助吗？
有用
有用
无用
无用