大模型体验中心
一站式体验由中国电信完全自主研发的星辰大模型及 AI 原生应用。
开发平台
为企业及开发者提供 AI 模型训练、应用开发等一站式工具与平台，降低开发门槛，加速AI应用落地。
应用产品
汇聚智能体应用、AI应用、大数据、软硬一体等标准化 AI 产品，覆盖多元场景，让 AI 能力从 “构想” 直连 “应用”
解决方案
以 “场景洞察 + 技术融合” 为锚，打造从需求诊断到价值落地的全链路方案，帮企业破解行业痛点，实现智能化转型 “精准突围”。
关于TeleAI
中国电信人工智能研究院（TeleAI）是中国电信旗下专注于人工智能技术研发与产业应用的核心机构。
热门搜索
- 超多方言实时语音识别
- AIGC
- 语义大模型
- 智能体平台
收起侧栏
最近更新时间: 8005200016(语音合成-V1.0.0)
接口信息
API Path
/aipaas/voice/v1/ttsSupernaturalNdialect/streaming
请求协议
WS
请求头部 ：
| 头部标签 | 必填 | 说明 | 类型 | 数据字典 | 限制 | 头部内容 | 示例 |
|---|---|---|---|---|---|---|---|
| Content-Type | 是 | 内容类型 | application/json | application/json | |||
| X-APP-ID | 是 | 买家中心-已购能力-【X-APP-ID】 | |||||
| Device-Uuid | 是 | 设备管理-设备uuid | |||||
| Authorization | 是 | 鉴权信息 | |||||
| 建立连接时的响应内容（websocket open） ： | |||||||
| 请求报文 ： |
请求参数 Json
Object
| 参数名 | 说明 | 必填 | 类型 | 数据字典 | 限制 | 示例 |
|---|---|---|---|---|---|---|
| req_id | 请求全局唯⼀ ID，记录该值便于排查问题 | 是 | [string] | 0 | ||
| text | 待合成的⽂本，需要为 UTF-8 编码 | 是 | [string] | 0 | ||
| format | 音频编码格式，支持 PCM 格式，默认值：PCM | 否 | [string] | 0 | ||
| sample_rate | ⾳频采样率，⽀持 24000Hz、22050Hz、16000 Hz 和 8000 Hz，默认值： 24000 | 否 | [int] | 0 | ||
| voice | 说话⼈，支持音色 guangzhounv、shanghainv、chengdunv、zhengzhounv、dongbeinv、 | 否 | [string] | 0 | ||
| volume | ⾳量，取值范围：[0, 100]，默认值：50 | 否 | [int] | 0 | ||
| speech_rate | 语速，取值范围：[0.5, 2.0]，默认值：1.0 | 否 | [float] | 0 | ||
| 响应报文 ： |
详细说明 ：
# 1、能力简介
* 支持输出格式：PCM 编码；
* 支持设置采样率：8000 Hz，16000 Hz， 22050Hz， 24000Hz；
* ⾳频为单声道，位深为 16 bit；
* 支持设置语速、音量；
* 支持设置多种说话人；
* ⽀持⼀次性合成 500 字符以内的文字，其中 1 个汉字、1 个英文字⺟、1 个标点或 1 个句⼦中间空格均算作 1 个字符，超过 500 个字符的内容将会截断，超过500字的文字不再进⾏合成；
* 仅支持采用 UTF-8 编码的文本输入；
# 2、修订历史
| 修订日期 | 算法版本号 | 修订内容 |
| ---- | ----- | ---- |
| 2025-12-09 | V1.0.0 | 首次发布 |
# 3、服务鉴权
服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。
# 4、请求参数说明
无
# 5、握手返回结果说明
#### 5.1 握手返回结果
| 返回码 | 说明 | 错误信息 | 解决⽅法 |
| --- | --- | ---- | ---- |
| 101 | 成功 | {"message":"success"} | 成功，开始语音合成 |
| 4001 | 授权失败 | {"message":"check sign fail"} | 联系商务，更新授权 |
| 4002 | 并发请求过多 | {"message":"Too many requests."} | 联系商务，增加并发 |
# 6、响应结果说明
## 6.1、开始合成响应示例
```json
{
"code": 10000,
"message": "Success",
"sid": "4eHgiLCBhbGdvcml"
}
```
## 6.2、接收合成数据响应示例
```json
{
"code": 10000,
"message": "Success",
"result": {
"audio": "//6YYmNiDlSUXjZlDP8yADQAQ1E2ANKJOaTqFGUgIwDQAKAA==",
"audio_len": 2500,
"is_end": false
}
}
```
## 6.3、合成结束响应示例
```json
{
"code": 10000,
"message": "Success",
"result": {
"audio": "//6YYmNiDlSUXjZlDP8yADQAQ1E2ANKJOaTqFGUgIwDQAKAA==",
"audio_len": 2500,
"is_end": true
}
}
```
# 7、请求示例
```json
{
"req_id": "3a87fe9793c9-4ebd-95d4-4ce2-a80c054b",
"text": "今天是周⼀，天⽓挺好的。"
}
```
# 8、状态码说明
| 状态码 | 解释 | 说明 | 解决方法 |
| --- | --- | --- | ---- |
| 10301 | Parameter error | 参数错误 | 检查请求体是否符合接口协议 |
| 10302 | Too many requests | 并发请求过多 | 联系商务，增加并发 |
| 10304 | Parse request body fail | 请求格式错误 | 查看请求的 URL body 格式是否正确，参考接口文档 |
| 10503 | Server connection time out | 服务连接超时 | 联系技术人员 |
| 10903 | Synthesis failed | 合成失败 | 联系技术人员 |
| 10000 | Success | 成功 | 执行下一步操作 |
1、能力简介
- 支持输出格式：PCM 编码；
- 支持设置采样率：8000 Hz，16000 Hz， 22050Hz， 24000Hz；
- ⾳频为单声道，位深为 16 bit；
- 支持设置语速、音量；
- 支持设置多种说话人；
- ⽀持⼀次性合成 500 字符以内的文字，其中 1 个汉字、1 个英文字⺟、1 个标点或 1 个句⼦中间空格均算作 1 个字符，超过 500 个字符的内容将会截断，超过500字的文字不再进⾏合成；
- 仅支持采用 UTF-8 编码的文本输入；
2、修订历史
| 修订日期 | 算法版本号 | 修订内容 |
| ---- | ----- | ---- |
| 2025-12-09 | V1.0.0 | 首次发布 |
3、服务鉴权
服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。
4、请求参数说明
无
5、握手返回结果说明
5.1 握手返回结果
| 返回码 | 说明 | 错误信息 | 解决⽅法 |
| --- | --- | ---- | ---- |
| 101 | 成功 | {"message":"success"} | 成功，开始语音合成 |
| 4001 | 授权失败 | {"message":"check sign fail"} | 联系商务，更新授权 |
| 4002 | 并发请求过多 | {"message":"Too many requests."} | 联系商务，增加并发 |
6、响应结果说明
6.1、开始合成响应示例
{
"code": 10000,
"message": "Success",
"sid": "4eHgiLCBhbGdvcml"
}
6.2、接收合成数据响应示例
{
"code": 10000,
"message": "Success",
"result": {
"audio": "//6YYmNiDlSUXjZlDP8yADQAQ1E2ANKJOaTqFGUgIwDQAKAA==",
"audio_len": 2500,
"is_end": false
}
}
6.3、合成结束响应示例
{
"code": 10000,
"message": "Success",
"result": {
"audio": "//6YYmNiDlSUXjZlDP8yADQAQ1E2ANKJOaTqFGUgIwDQAKAA==",
"audio_len": 2500,
"is_end": true
}
}
7、请求示例
{
"req_id": "3a87fe9793c9-4ebd-95d4-4ce2-a80c054b",
"text": "今天是周⼀，天⽓挺好的。"
}
8、状态码说明
| 状态码 | 解释 | 说明 | 解决方法 |
| --- | --- | --- | ---- |
| 10301 | Parameter error | 参数错误 | 检查请求体是否符合接口协议 |
| 10302 | Too many requests | 并发请求过多 | 联系商务，增加并发 |
| 10304 | Parse request body fail | 请求格式错误 | 查看请求的 URL body 格式是否正确，参考接口文档 |
| 10503 | Server connection time out | 服务连接超时 | 联系技术人员 |
| 10903 | Synthesis failed | 合成失败 | 联系技术人员 |
| 10000 | Success | 成功 | 执行下一步操作 |