You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
音频转码
GetAudioConvertJob
复制全文
下载 pdf
GetAudioConvertJob
功能描述​
此接口用于查询音频转码任务。​
注意事项​
通过子账号使用时,必须拥有 GetDataProcessJob 数据处理所需的相关权限。​
请求消息样式​
​
GET /?job_type=AudioConvert&job_id=fa81ef2a00a2211f08a9aa5**********HTTP/1.1​
Host: <bucket_name>.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: <authorization_string>​
​
请求参数和消息头​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
job_id​
Query​
String​
是​
183535129563a53bfa710001887ae45ac629 ​
音频转码任务 ID。​
job_type​
Query​
String​
是​
AudioConvert​
任务类型,音频转码场景下取值仅为 AudioConvert。​
​
请求元素​
该请求不使用消息元素。​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
参数名称​
参数类型​
示例值​
说明​
JobID​
String​
fa81ef2a00a2211f08a9aa5**********​
任务 ID。​
CreateTime​
String​
2025-03-26T17:14:01+0800​
任务创建时间。​
StartTime​
String​
2025-03-26T17:14:02+0800​
任务开始时间。​
EndTime​
String​
2025-03-26T17:14:02+0800​
任务结束时间。​
State​
String​
Success​
任务状态。​
Code​
Integer​
0​
任务状态码。​
Message​
String​
Success​
任务状态消息。​
Input​
String ​
-​
输入文件。​
Object​
String​
​
sample.mp4​
输入文件对象名。​
父节点:Input。​
AudioConvertConfig​
String​
-​
音频转码任务详情信息。​
ContainerFormat​
String​
mp3​
指定转码容器格式,取值列表如下:​
  • wav​
  • mp3​
  • aac​
  • flac​
  • oga​
  • ac3​
  • opus​
  • m4a​
父节点:AudioConvertConfig。​
TimeInterval​
String​
-​
指定转码时长。​
父节点:AudioConvertConfig。​
Start​
Integer​
0​
开始时间,单位毫秒,默认值 0。​
父节点:TimeInterval。​
Duration​
Integer​
1000​
持续时间,单位毫秒,默认值为 0 时表示视频时长。​
父节点:TimeInterval。​
BitRate​
Integer​
8000​
音频码率,取值范围[8000, 1000000],为 0 时使用原音频码率,部分容器不支持指定码率。​
说明​
不同格式支持的声道数有所不同,详情请参见不同音频容器参数支持情况。​
父节点:AudioConvertConfig。​
BitRateOpt​
Integer​
0​
音频码率选项。取值如下:​
  • 0(默认值):始终使用目标音频码率。​
  • 1:源音频码率小于BitRate时使用源音频码率。​
  • 2:源音频码率小于BitRate时返回失败。​
父节点:AudioConvertConfig。​
SampleFormat​
Integer​
-​
音频采样格式,不同容器取值范围不同。​
父节点:AudioConvertConfig。​
SampleRate​
Integer​
48000​
音频采样率,不同容器取值范围不同。​
父节点:AudioConvertConfig。​
说明​
不同格式支持的采样率有所不同,详情请参见不同音频容器采样率支持情况。
Channels​
Integer​
2​
音频声道数,不同容器取值范围不同。​
父节点:AudioConvertConfig。​
说明​
不同格式支持的声道数有所不同,详情请参见不同音频容器参数支持情况。
Output​
String​
-​
输出文件。​
Region​
String​
cn-beijing​
输出文件桶所在 Region。​
父节点:Output。​
Bucket​
String​
testbkt​
输出文件桶名。​
父节点:Output。​
Object​
String​
output.mp4​
输出文件对象名。​
父节点:Output。​
​
请求示例​
​
GET /?job_type=AudioConvert&job_id=fa81ef2a00a2211f08a9aa5**********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​
​
{​
"JobID": "fa81ef2a00a2211f08a9aa5**********",​
"CreateTime": "2025-03-26T17:14:01+0800",​
"StartTime": "2025-03-26T17:14:02+0800",​
"EndTime": "2025-03-26T17:14:02+0800",​
"State": "Success",​
"Code": 0,​
"Message": "success",​
"Input" : { // 源文件​
"Object" : "sample.wav" ​
},​
"AudioConvertConfig": {​
"ContainerFormat": "mp3",​
"TimeInterval": {​
"Start": 0,​
"Duration": 1000​
},​
"BitRate": 8000,​
"BitRateOpt": 0,​
"SampleFormat": "",​
"SampleRate": 48000,​
"Channels": 2​
},​
"Output" : { // 输出文件​
"Region" : "cn-beijing", ​
"Bucket" : "testbkt",​
"Object" : "output.mp3"​
}​
}​
​
​
最近更新时间:2026.08.03 15:17:34
这个页面对您有帮助吗?
有用
有用
无用
无用