# 创建任务的请求

# 功能描述

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

# 请求

# 请求示例

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. 最后将分词完之后的短句返回给前端

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