# 创建任务的请求

# 功能描述

后台服务器用来给任务调度器发起转码、合成的任务

# 请求

# 请求示例

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里没有列出。 原因是,语音识别过程包含多个任务。

  1. 首先根据前端的trimin 、trimout调用任务调度器,发起转码服务,得到该时间段内的音频文件
  2. 用户调用第三方能力(讯飞等)自己实现根据音频生成文字的过程
  3. 生成的文字一般比较长,放在前端可能大于一行,这个时候就有必要调用任务调度器发起一个分词的任务,将长句分为短句
  4. 最后将分词完之后的短句返回给前端

所以不提供语音识别任务的创建