# 创建任务的请求
# 功能描述
后台服务器用来给任务调度器发起转码、合成的任务
# 请求
# 请求示例
POST /job/create HTTPS
Host: <host>
Content-Type: application/json
# 请求参数
无
# 请求头
无
# 请求体
请求体是json字符串,例如:
{
"uuid": "uuid", // 任务UUID
"type": 0, // 任务类型,0--转码,1--合成
"data": {
"url": "...", // 如果是转码任务,是视音频的url;如果是合成任务,是工程文件的url
"licUrl":"....", //如果是安装特效包的任务,需要同时传lic的地址
"callbackHost": "...", // 回调的Host
"resourceType":1, // 任务资源类型
"isDir":false, // 是否是目录
"isSingleSlice": false, // 是否转单片的视频
"isAlpha": false, // 是否转alpha视频
"resourceNames":['name-00000.tga',..., 'name-00009.tga'] //目录资源的资源文件名列表
"compareAudioUrl":"http://.....",//音频对齐的另一个音频url
"trimIn":1234, // 用于语音转码一部分的开始的时间 微秒
"trimOut":2345, // 用于语音转码一部分的结束的时间 微秒
"maxWordLength":24, //分词器会对字数大于该值的长句进行分词
"onlyTranscodeThumbnail":false, //转码任务只需要生成缩率图
"pathPrefix":"99999",//类似多租户的概念,可以将本次的资源上传到9999这个目录 不要带"/"
"reviewPrefix":"www.baidu.com"// 使用的云存储域名
}
}
字段 | 类型 | 描述 | 必填 |
---|---|---|---|
uuid | string | 任务UUID | 是 |
type | int | 任务类型, 0--转码 1--合成 4--音频对齐 5--分词 | 是 |
data | object | 任务数据 | 是 |
url | string | -- 如果是转码任务,是视音频的url; -- 如果是合成任务,是工程文件的url; -- 如果是音频对齐任务,是其中一个音频文件的url; -- 如果是分词任务,就是语音转写之后的json文件内容,一般格式为 [ { "bg": "0", //开始时间 "ed": "1850", //结束时间 "onebest": "...", //待分词内容 "speaker": "0" //暂时不用 } ... ] | 是 |
licUrl | String | 如果是安装特效包的任务,需要同时包含licUrl | 是 |
callbackHost | string | 回调的Host | 是 |
resourceType | int | 任务资源类型 1.视频,2.音频,3.图像 4.语音部分转码 | 转码时必填 |
isDir | boolean | 是否为目录 | 否 |
isSingleSlice | boolean | 是否分片 | 否 |
isAlpha | boolean | 是否转alpha视频 | 否 |
resourceNames | array | 目录资源的资源文件名列表 | 否 |
compareAudioUrl | string | 要对齐的音频的另一个音频url | 音频对齐时必填 |
maxWordLength | Integer | 分词器会对字数大于该值的长句进行分词 | 否 |
trimIn | Long | 用于语音转码一部分的开始的时间 微秒 | 否 |
trimOut | Long | 用于语音转码一部分的结束的时间 微秒 | 否 |
onlyTranscodeThumbnail | boolean | 转码任务只需要生成缩率图 | 否 |
pathPrefix | string | 类似多租户的概念,可以将本次的资源上传到这个根目录 字符串的开头不要带"/" | 否 |
reviewPrefix | string | 云存储域名,请确保该域名对应的bucket和项目中一致,且要和pathPrefix结合。 如:希望的pathPrefix是"/test/159",原域名是"https://test.com" 则这个值是"https://test.com (opens new window)/test/159",此时就可以不传pathPrefix 来指定pathPrefix。 | 否 |
# 响应
# 响应头
此接口无特殊响应头。
# 响应体
{
"code": 0,// 0成功 1失败
"msg": "success"
}
# 补充说明
语音识别的任务类型为2,这种任务不能通过该接口发起,所以在请求体的type里没有列出。 原因是,语音识别过程包含多个任务。
- 首先根据前端的trimin 、trimout调用任务调度器,发起转码服务,得到该时间段内的音频文件
- 用户调用第三方能力(讯飞等)自己实现根据音频生成文字的过程
- 生成的文字一般比较长,放在前端可能大于一行,这个时候就有必要调用任务调度器发起一个分词的任务,将长句分为短句
- 最后将分词完之后的短句返回给前端
所以不提供语音识别任务的创建