长文本在线合成API
更新时间：2025-02-27
接口描述
长文本在线合成接口可以将10万字以内文本一次性合成，异步返回音频。支持多种优质音库，将超长文本快速转换成稳定流畅、饱满真实的音频。适用于阅读听书、新闻播报等客户。
步骤： 1、根据文本内容、音频格式、音库等参数创建语音合成任务，获取task_id参数。 2、根据task_id的数组批量查询语音合成任务结果。
在线调试&示例代码
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
Python Demo 点击下载 （文件为.zip压缩包，若无法打开时，可尝试在文件后上增加".zip"后缀）
创建长文本在线合成任务-请求说明
请求接口：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。默认为度小美 臻品音库：度逍遥（臻品）=4003，度博文=4106，度小贤=4115，度小鹿=4119，度灵儿=4105，度小乔=4117，度小雯=4100，度米朵=4103，度姗姗=4144，度小贝=4278，度清风=4143，度小新=4140，度小彦=4129，度星河=4149，度小清=4254，度博文=4206，南方=4226。大模型发音人：度涵竹=4189，度嫣然=4194，度泽言=4193，度怀安=4195，度清影=4196，度沁遥=4197，度小粤=20100，度晓芸=20101，四川小哥=4257，度阿闽=4132,度小蓉=4139,台媒女声=5977,度小台=4007,度湘玉=4150,度阿锦=4134,度筱林=4172 更多发音人请查看音色列表 |
| lang | string | 是 | 语言 | 固定值zh。语言选择,目前只有中英文混合模式，填写固定值zh |
| speed | int | 否 | 语速 | 取值0-15，默认为5中语速 |
| pitch | int | 否 | 音调 | 取值0-15，默认为5中语调 |
| volume | int | 否 | 音量 | 音量，基础音库取值0-9，精品音库取值0-15，默认为5中音量（取值为0时为音量最小值，并非为无声） |
| enable_subtitle | int | 否 | 是否开启字幕时间戳 | 取值范围0, 1, 2，默认为0。0表示不开启字幕时间戳，1表示开启句级别字幕时间戳，2表示开启词级别字幕时间戳 |
| break | int | 否 | 段落间隔 | 取值 0-5000 ，单位ms，用于合成文本分段传入时设置段落间间隔。 |
请求示例：
Plain Text
1{
2 "text": [
3 "今年上半年我国工业经济面临的内外部环境还是比较严峻复杂的",
4 "段落2",
5 "段落3"
6 ],
7 "format": "mp3-16k",
8 "voice": 3,
9 "lang": "zh",
10 "speed": 5,
11 "enable_subtitle": 2,
12 "break": 0
13}创建长文本在线合成任务-返回说明
返回参数
| 参数名 | 类型 | 是否必需 | 对外状态 |
|---|---|---|---|
| log_id | int | 是 | log id |
| task_id | str | 否 | 任务id。注意保存该id，用于后续请求结果 |
| task_status | str | 否 | 任务状态 |
| error_code | int | 否 | 错误码 |
| error_msg | str | 否 | 错误信息 |
返回示例：
Plain Text
1创建成功
2{
3 "log_id": 1234567890,
4 "task_id": "234acb234acb234acb234acb", #注意保存该id，用于后续请求结果
5 "task_status": "Running"
6}
7创建失败，缺少参数
8{
9 "error_code": 100000,
10 "error_msg": "missing param: xxx",
11 "log_id": 5414433131138366128
12}注意：查询结果时，需要该步骤返回的task_id来进行请求。请注意保存task_id列表。
查询长文本在线合成任务-请求说明
请求接口：https://aip.baidubce.com/rpc/2.0/tts/v1/query
HTTP 方法：POST
URL参数：
| 参数 | 取值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考Access Token获取 |
Body中放置请求参数，参数如下：
| 参数名 | 类型 | 是否必需 | 描述 | 取值范围 |
|---|---|---|---|---|
| task_ids | list | 是 | 任务id | 推荐一次查询多个任务id，单次最多可查询200个 |
请求示例：
Plain Text
1{
2 "task_ids": ["234acb234acb234acb234acb", "234acb234acb234acb234acd", "234acb234acb234acb234acbe"]
3}查询长文本在线合成任务-返回说明
返回参数：
| 参数名 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| log_id | int | 是 | log id |
| tasks_info | list | 否 | 任务信息 |
| +task_id | str | 是 | 任务id |
| +task_status | str | 是 | 任务状态 |
| +task_result | dict | 否 | 任务结果 |
| ++speech_url | str | 否 | 音频下载链接，任务完成后储存72小时 |
| ++speech_timestamp | dict | 否 | 字幕时间戳信息 |
| +++sentences | list | 否 | 句子列表 |
| ++++paragraph_index | int | 否 | 句子在传入文本中段落位置 |
| ++++sentence_texts | str | 否 | 句子文本信息 |
| ++++begin_time | int | 否 | 句子文本在合成音频的开始时间戳 |
| ++++end_time | int | 否 | 句子文本在合成音频的结束时间戳 |
| ++++characters | list | 否 | 句子中各个词的信息 |
| +++++character_text | str | 否 | 句子中的词文本 |
| +++++begin_time | int | 否 | 句子中的词在合成音频的开始时间戳 |
| +++++end_time | int | 否 | 句子中的词在合成音频的结束时间戳 |
| ++err_no | int | 否 | 错误码 |
| ++err_msg | str | 否 | 错误信息 |
| ++sn | str | 否 | |
| error_code | int | 否 | 错误码 |
| error_msg | str | 否 | 错误信息 |
| error_info | list | 否 | 错误的或查询不存在taskId数组 |
返回示例：
Plain Text
1{
2 "log_id": 16739423288701914,
3 "tasks_info": [
4 {
5 "task_status": "Success",
6 "task_result": {
7 "speech_url": "http://bj.bcebos.com/aipe-speech/text_to_speech/2023-01-17/63c6550e52064d000104da0d/speech/0.mp3?authorization=bce-auth-v1%2F8a6ca9b78c124d89bb6bca18c6fc5944%2F2023-01-17T07%3A58%3A12Z%2F259200%2F%2Fbb3f38b53425ced397a107aebe21d2e951ed0e27a964f39c2a350249ba07b47c",
8 "speech_timestamp": {
9 "sentences": [
10 { "paragraph_index": 0,
11 "sentence_texts": "今年上半年我国工业经济面临的内外部环境还是比较严峻复杂的",
12 "begin_time": 104,
13 "end_time": 5970,
14 "characters": [
15 {
16 "character_text": "今",
17 "begin_time": 106,
18 "end_time": 313
19 },
20 {
21 "character_text": "年",
22 "begin_time": 316,
23 "end_time": 522
24 },
25 {
26 "character_text": "上",
27 "begin_time": 525,
28 "end_time": 732
29 },
30 {
31 "character_text": "半",
32 "begin_time": 735,
33 "end_time": 941
34 },
35 {
36 "character_text": "年",
37 "begin_time": 944,
38 "end_time": 1151
39 },
40 {
41 "character_text": "我",
42 "begin_time": 1154,
43 "end_time": 1360
44 },
45 {
46 "character_text": "国",
47 "begin_time": 1363,
48 "end_time": 1570
49 },
50 {
51 "character_text": "工",
52 "begin_time": 1573,
53 "end_time": 1779
54 },
55 {
56 "character_text": "业",
57 "begin_time": 1782,
58 "end_time": 1989
59 },
60 {
61 "character_text": "经",
62 "begin_time": 1992,
63 "end_time": 2198
64 },
65 {
66 "character_text": "济",
67 "begin_time": 2201,
68 "end_time": 2408
69 },
70 {
71 "character_text": "面",
72 "begin_time": 2411,
73 "end_time": 2617
74 },
75 {
76 "character_text": "临",
77 "begin_time": 2620,
78 "end_time": 2827
79 },
80 {
81 "character_text": "的",
82 "begin_time": 2830,
83 "end_time": 3036
84 },
85 {
86 "character_text": "内",
87 "begin_time": 3039,
88 "end_time": 3246
89 },
90 {
91 "character_text": "外",
92 "begin_time": 3249,
93 "end_time": 3455
94 },
95 {
96 "character_text": "部",
97 "begin_time": 3458,
98 "end_time": 3664
99 },
100 {
101 "character_text": "环",
102 "begin_time": 3667,
103 "end_time": 3874
104 },
105 {
106 "character_text": "境",
107 "begin_time": 3877,
108 "end_time": 4083
109 },
110 {
111 "character_text": "还",
112 "begin_time": 4086,
113 "end_time": 4293
114 },
115 {
116 "character_text": "是",
117 "begin_time": 4296,
118 "end_time": 4502
119 },
120 {
121 "character_text": "比",
122 "begin_time": 4505,
123 "end_time": 4712
124 },
125 {
126 "character_text": "较",
127 "begin_time": 4715,
128 "end_time": 4921
129 },
130 {
131 "character_text": "严",
132 "begin_time": 4924,
133 "end_time": 5131
134 },
135 {
136 "character_text": "峻",
137 "begin_time": 5134,
138 "end_time": 5340
139 },
140 {
141 "character_text": "复",
142 "begin_time": 5343,
143 "end_time": 5550
144 },
145 {
146 "character_text": "杂",
147 "begin_time": 5553,
148 "end_time": 5759
149 },
150 {
151 "character_text": "的",
152 "begin_time": 5762,
153 "end_time": 5969
154 }
155 ]
156 }
157 ]
158 }
159 },
160 "task_id": "63c6550e52064d000104da0d"
161 }
162 ]
163}