长文本语音合成-查询结果
更新时间：2025-04-17
配合长文本语音合成接口使用，用于在生成合成任务后查询结果。
POST
https://aip.baidubce.com/rpc/2.0/tts/v1/query
在调用长文本语音合成接口后，根据task_id查询语音合成任务的结果。
权限说明
调用本能力需要使用API Key进行鉴权认证。获取及使用API Key的流程请参考：APIKey鉴权说明文档
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
task_ids
object {0}
一次可查询多个任务id，单次最多可查询200个
可选
显示子属性
隐藏子属性
请求结构
POST https://aip.baidubce.com/rpc/2.0/tts/v1/query
Authorization: API Key String
Content-Type: application/json
{
"task_ids": ["234acb234acb234acb234acb", "234acb234acb234acb234acd", "234acb234acb234acb234acbe"]
}示例代码
请求示例
curl --location --request POST 'https://aip.baidubce.com/rpc/2.0/tts/v1/query' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--header 'Content-Type: application/json' \
--data-raw '{
"task_ids": ["67d3e4d5013947024ab1af7"]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
tasks_info
object {3}
任务信息
可选
显示子属性
隐藏子属性
task_id
string
任务id
可选
task_status
string
任务状态
可选
task_result
object {2}
任务结果
可选
显示子属性
隐藏子属性
speech_url
string
音频下载链接，任务完成后储存72小时
可选
speech_timestamp
object {1}
字幕时间戳信息
可选
显示子属性
隐藏子属性
sentences
object {5}
句子列表
可选
显示子属性
隐藏子属性
paragraph_index
integer
句子在传入文本中段落位置
可选
sentence_texts
string
句子文本信息
可选
begin_time
integer
句子文本在合成音频的开始时间戳
可选
end_time
integer
句子文本在合成音频的结束时间戳
可选
characters
object {3}
句子中各个词的信息
可选
显示子属性
隐藏子属性
character_text
string
句子中的词文本
可选
begin_time
integer
句子中的词在合成音频的开始时间戳
可选
end_time
integer
句子中的词在合成音频的结束时间戳
可选
响应示例
{
"log_id": 16739423288701914,
"tasks_info": [
{
"task_status": "Success",
"task_result": {
"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",
"speech_timestamp": {
"sentences": [
{ "paragraph_index": 0,
"sentence_texts": "今年上半年我国工业经济面临的内外部环境还是比较严峻复杂的",
"begin_time": 104,
"end_time": 5970,
"characters": [
{
"character_text": "今",
"begin_time": 106,
"end_time": 313
},
{
"character_text": "年",
"begin_time": 316,
"end_time": 522
},
{
"character_text": "上",
"begin_time": 525,
"end_time": 732
},
{
"character_text": "半",
"begin_time": 735,
"end_time": 941
},
{
"character_text": "年",
"begin_time": 944,
"end_time": 1151
},
{
"character_text": "我",
"begin_time": 1154,
"end_time": 1360
},
{
"character_text": "国",
"begin_time": 1363,
"end_time": 1570
},
{
"character_text": "工",
"begin_time": 1573,
"end_time": 1779
},
{
"character_text": "业",
"begin_time": 1782,
"end_time": 1989
},
{
"character_text": "经",
"begin_time": 1992,
"end_time": 2198
},
{
"character_text": "济",
"begin_time": 2201,
"end_time": 2408
},
{
"character_text": "面",
"begin_time": 2411,
"end_time": 2617
},
{
"character_text": "临",
"begin_time": 2620,
"end_time": 2827
},
{
"character_text": "的",
"begin_time": 2830,
"end_time": 3036
},
{
"character_text": "内",
"begin_time": 3039,
"end_time": 3246
},
{
"character_text": "外",
"begin_time": 3249,
"end_time": 3455
},
{
"character_text": "部",
"begin_time": 3458,
"end_time": 3664
},
{
"character_text": "环",
"begin_time": 3667,
"end_time": 3874
},
{
"character_text": "境",
"begin_time": 3877,
"end_time": 4083
},
{
"character_text": "还",
"begin_time": 4086,
"end_time": 4293
},
{
"character_text": "是",
"begin_time": 4296,
"end_time": 4502
},
{
"character_text": "比",
"begin_time": 4505,
"end_time": 4712
},
{
"character_text": "较",
"begin_time": 4715,
"end_time": 4921
},
{
"character_text": "严",
"begin_time": 4924,
"end_time": 5131
},
{
"character_text": "峻",
"begin_time": 5134,
"end_time": 5340
},
{
"character_text": "复",
"begin_time": 5343,
"end_time": 5550
},
{
"character_text": "杂",
"begin_time": 5553,
"end_time": 5759
},
{
"character_text": "的",
"begin_time": 5762,
"end_time": 5969
}
]
}
]
}
},
"task_id": "63c6550e52064d000104da0d"
}
]
}
长文本合成结果错误码
| err_no | err_msg | 描述 |
|---|---|---|
| 100000 | Inner error | 内部错误 |
| 100001 | Format is not supported | 不支持的音频格式 |
| 100002 | Failed to query texts from uri | 获取文本内容失败 |
| 100003 | Failed to upload results to BOS | 上传音频文件失败 |
| 100010 | Inner error: TTS failed | 合成音频服务失败 |
| 100020 | Authentication and Rate Limit Failed | 鉴权流控不通过，请检查额度 |
| 100022 | A http exception occurred during Authentication and Rate Limitation HTTP网络交互失败 |