创建长文本在线合成任务
接口描述:根据文本内容、音频格式、音库等参数创建语音合成任务
请求接口:https://aip.baidubce.com/rpc/2.0/tts/v1/create
HTTP 方法:POST
URL参数:
参数 | 取值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考Access Token获取 |
Body中按JSON格式放置请求参数,参数如下:
参数名 | 类型 | 是否必需 | 描述 | 取值范围 |
---|---|---|---|---|
text | list | 是 | 待合成的文本,需要为UTF-8编码;输入多段文本时,文本间会插入1s长度的空白间隔 | 总字数不超过10万个字符,1个中文字、英文字母、数字或符号均算作1个字符 |
format | string | 否 | 音频格式 | "mp3-16k","mp3-48k","wav","pcm-8k","pcm-16k",默认为mp3-16k |
voice | int | 否 | 音库 |
基础音库:度小宇=1,度小美=0,度逍遥(基础)=3,度丫丫=4; 精品音库:度逍遥(精品)=5003,度小鹿=5118,度博文=106,度小童=110,度小萌=111,度米朵=103,度小娇=5。默认为度小美 |
lang | int | 是 | 语言 | 固定值zh。语言选择,目前只有中英文混合模式,填写固定值zh |
speed | int | 否 | 语速 | 取值0-15,默认为5中语速 |
pitch | int | 否 | 音调 | 取值0-15,默认为5中语调 |
volume | int | 否 | 音量 | 取值0-15,默认为5中音量(取值为0时为音量最小值,并非为无声) |
Body请求示例:
{
"text":[
"人生就像一场戏",
"因为有缘才相聚",
"相扶到老不容易",
"是否更该去珍惜"
],
"format": "pcm-16k",
"voice":1,
"lang":"zh"
}
返回参数
参数名 | 类型 | 是否必需 | 对外状态 |
---|---|---|---|
log_id | int | 是 | log id |
task_id | str | 否 | 任务id。注意保存该id,用于后续请求结果 |
task_status | str | 否 | 任务状态 |
error_code | int | 否 | 错误码 |
error_msg | str | 否 | 错误信息 |
Body返回示例:
创建成功
{
"log_id": 1234567890,
"task_id": "234acb234acb234acb234acb", #注意保存该id,用于后续请求结果
"task_status": "Running"
}
创建失败,缺少参数
{
"error_code": 100000,
"error_msg": "missing param: xxx",
"log_id": 5414433131138366128
}
注意:查询结果时,需要该步骤返回的task_id来进行请求。请注意保存task_id列表。