大模型服务平台 TokenHub Tenlai 同步语音合成

一、前提条件

·已注册腾讯云账号并开通 TokenHub 服务。

·已在 TokenHub 控制台获取 API Key。

二、接口信息

项	值
地址	https://tokenhub.tencentmaas.com/v1/tenlai/ttsproxy/text_to_voice
方法	POST
Content-Type	application/json
鉴权	Authorization: Bearer YOUR_API_KEY

三、支持模型

模型名称	model（调用参数）	能力说明
Tenlai-TTS-v1	tenlai-tts-v1.0	天籁语音合成，音质自然流畅，适合内容播报、有声阅读等场景。

四、请求示例

非流式cURLcurl -X POST 'https://tokenhub.tencentmaas.com/v1/tenlai/ttsproxy/text_to_voice' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "tenlai-tts-v1.0", "text": "刚吹过晚风的巷口飘着糖炒栗子的香，连路灯都软乎乎的。", "voice_setting": { "voice_id": 502001, "speed": 1, "volume": 0 }, "audio_setting": { "sample_rate": 16000 }, "output_format": "mp3"}'

五、请求参数

参数	类型	必选	说明
model	string	是	模型名 tenlai-tts-v1.0
text	string	是	合成语音的源文本，按 UTF-8编码统一计算。中文最大支持100个汉字（全角标点符号算一个汉字）；英文最大支持约300个字母。示例值：你好
voice_setting.voice_id	string	是	音色编号，支持系统音色，详情可参考：云小洋 403008YunLeo 403007YunMia 403006云雅琴 403005云大川 403004云小天 403003云大围 402002云小团 402001云晓芙 402000云小朵 403000云小帅 403002云小和 403001邻家女孩 603007沉稳青叔 603006知心大林 603005温柔小柠 603004随和老李 603003软萌心心 603002潇湘妹妹 603001懂事少年 603000专业梓欣 602005暖心阿灿 602004智小虎 502007智小悟 502006智小解 502005爱小悠 602003智小满 502004智小敏 502003智小柔 502001
voice_setting.speed	float	否	语速，默认 1.0，范围 [-2, 6]
voice_setting.volume	float	否	音量，默认 0，范围 [-10，10]
audio_setting.sample_rate	integer	否	采样率，默认 16000，可选 16000 / 24000 / 8000
output_format	string	否	返回音频格式，可取值：mp3，pcm示例值：mp3

六、返回示例

非流式流式{ "data": { "audio_url": "https://asr-console-cos-1256237915.cos.ap-guangzhou.myqcloud.com/tenlai_maas/tts/1256237915/20261026/8284d9f6-6936-4961-9290-38513497ebb3.mp3?q-sign-algorithm=sha1&q-ak=AKIDU1KRRAraBdz8GBMWh0ITOJ1Xv5ezuByX&q-sign-time=1793026168%3B1793630968&q-key-time=1793026168%3B1793630968&q-header-list=host&q-url-param-list=&q-signature=4396cea265e30a4f1f7369b66fdb264153f33acd" }, "status": "completed", "trace_id": "8284d9f6-6936-4961-9290-38513497ebb3"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio0>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio1>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio2>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio3>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio4>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"audio":"<hex编码的audio5>","status":1},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40"}data: {"base_resp":{"status_code":0,"status_msg":"success"},"data":{"status":2},"request_id":"2d4e75ca-229e-4c77-9853-629f3b142786","status":"completed","trace_id":"th_251414125_r00c00_minimax-tts_96633db4153604d295fe0a565d0bea40","usage":{"chars":50,"total_tokens":1750,"use_count":26}}data: [DONE]

七、返回字段

字段	类型	说明
data.audio_url	string	Base64编码的 mp3/pcm 音频数据示例值：UklGRlR/AABXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YSx9AAD+
status	integer	{ "0": "queued", "1": "in_progress", "2": "completed", "3": "failed" }
trace_id	string	本次会话 ID，用于咨询/反馈时定位问题。

八、错误码

请参见 API 错误码说明。