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

对象存储

复制全文
下载 pdf
视频转码
CreateSpeechRecognitionJob
复制全文
下载 pdf
CreateSpeechRecognitionJob
功能描述​
此接口用于创建音视频语音识别任务,识别结果可通过查询任务获取,也可以转存为 JSON 文件。​
注意事项​
  • 语音识别任务仅支持异步处理。​
  • 使用子账号操作时,请先在访问控制 > 权限策略中创建或编辑自定义策略,为当前桶添加 tos:CreateMediaProcessJobs权限,再将该策略绑定至需要使用本功能的子账号。​
  • Output.Object 参数可选填。不填时,识别结果仅可通过查询任务接口获取;若填写,文件后缀必须为 .json。​
请求消息样式​
​
POST /?job_type=SpeechRecognition&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: <length>​
Authorization: authorization string​
​
{​
"Input": {​
"Object": "sample.mp4"​
},​
"SpeechRecognitionConfig": {​
"Language": "auto",​
"SingleSegment": false,​
"OutputFormat": "json"​
},​
"Output": {​
"Region": "cn-beijing",​
"Bucket": "testbkt",​
"Object": "speech-result.json"​
}​
}​
​
请求参数和消息头​
该请求使用的公共请求消息头,请参见公共参数。​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
job_type​
Query​
String​
是​
SpeechRecognition​
任务类型,语音识别场景下取值仅为 SpeechRecognition。​
media_jobs​
Query​
String​
是​
-​
代表媒体任务的请求特殊标识。​
​
请求元素​
​
名称​
参数类型​
是否必选​
示例值​
说明​
Input​
Container​
是​
-​
源文件。​
Object​
String​
是​
sample.mp4​
待识别的源音视频文件名称。 ​
父节点:Input。​
SpeechRecognitionConfig​
Container​
是​
-​
语音识别任务具体配置。​
Language​
String​
否​
auto​
识别语言,默认值为 auto,取值为如下:​
  • zh​
  • en​
  • auto​
父节点:SpeechRecognitionConfig。​
SingleSegment​
Boolean​
否​
false​
是否输出为单段结果,取值如下:​
  • true​
  • false​
父节点:SpeechRecognitionConfig。​
OutputFormat​
String​
否​
json​
识别结果输出格式,当前仅支持 json,默认值为 json。 ​
父节点:SpeechRecognitionConfig。​
Output​
Container​
否​
-​
识别结果转存配置。不填 Object 时,识别结果仅通过查询任务获取。​
Region​
String​
否​
cn-beijing​
识别结果转存地域。 ​
父节点:Output。​
Bucket​
String​
否​
testbkt​
识别结果转存 Bucket。 ​
父节点:Output。​
Object​
String​
否​
speech-result.json​
识别结果转存对象名。填写时后缀必须与 OutputFormat 一致。 ​
父节点:Output。​
​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
Code​
String​
OK​
状态码。​
Message​
String​
Success​
请求状态信息。​
JobId​
String​
187919df106a49aa402300013e6ba5bf0593​
语音识别任务 ID。​
​
请求示例​
​
POST /?job_type=SpeechRecognition&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: <length>​
Authorization: authorization string​
​
{​
"Input": {​
"Object": "sample.mp4"​
},​
"SpeechRecognitionConfig": {​
"Language": "auto",​
"SingleSegment": false,​
"OutputFormat": "json"​
},​
"Output": {​
"Region": "cn-beijing",​
"Bucket": "testbkt",​
"Object": "speech-result.json"​
}​
}​
​
响应示例​
​
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: 80​
​
{​
"Code": "OK",​
"Message": "Success",​
"JobId": "187919df106a49aa402300013e6ba5bf0593"​
}​
​
最近更新时间:2026.09.16 11:14:20
这个页面对您有帮助吗?
有用
有用
无用
无用