资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

创建任务

在线调试

您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

创建长文本在线合成任务

接口描述:根据文本内容、音频格式、音库等参数创建语音合成任务

请求接口: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 string 语言 固定值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列表。