POST /api/open/characters/{id}/tts — 流式语音合成

流式语音合成

更新时间：2026/08/18

返回音频流（PCM-16 LE 单声道或 OGG/Opus 容器）。响应头携带采样率与编码格式。

注意

使用场景：该接口用于角色语音试听；音色通过角色配置（tts_voice_id）指定，内置音色清单见下表。

🔧请求信息

请求 URI

POST https://lg.jimitu.top/api/open/characters/{id}/tts

请求头参数

Header	必填	说明
`Authorization`	是	Bearer {API Key}，接口鉴权，所有请求均需携带
`Content-Type`	否	仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json

请求路径参数

参数	类型	必填	说明
id	integer	是	角色实例 ID

请求体参数

字段	类型	必填	说明
text	string	是	要合成的文本
voice_id	string	否	内置音色名或自定义音色 ID，不传用角色配置

请求示例

curl -X POST "https://lg.jimitu.top/api/open/characters/{id}/tts" \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "要合成的文本",
    "voice_id": "（可选，内置音色名或自定义音色 ID）"
  }'

📥响应信息

响应

响应头：X-Sample-Rate（如 24000）、X-Audio-Codec（pcm / opus）
响应体：音频二进制流（Transfer-Encoding: chunked）

⚠️错误码

错误码

场景	HTTP 状态码	error_code
角色未启用 TTS	400	`TTS_NOT_ENABLED`
TTS 配置错误（缺少端点/密钥）	400	`TTS_CONFIG_ERROR`
角色不存在	404	`CHARACTER_NOT_FOUND`
令牌无权限	403	—

注意

语音优先级：请求 voice_id > 角色 settings.tts.voiceId > 默认 af_maple。

📋其他

内置音色清单

voice_id	中文名	性别	描述
Cherry	芊悦	女	阳光积极、亲切自然小姐姐
Serena	苏瑶	女	温柔小姐姐
Ethan	晨煦	男	标准普通话带部分北方口音，阳光温暖活力朝气
Chelsie	千雪	女	二次元虚拟女友
Momo	茉兔	女	撒娇搞怪，逗你开心
Vivian	十三	女	拽拽的、可爱的小暴躁
Moon	月白	男	率性帅气
Maia	四月	女	知性与温柔的碰撞
Kai	凯	男	耳朵的一场SPA
Nofish	不吃鱼	男	不会翘舌音的设计师
Bella	萌宝	女	喝酒不打醉拳的小萝莉
Eldric Sage	沧明子	男	沉稳睿智的老者，沧桑如松却心明如镜
Mia	乖小妹	女	温顺如春水，乖巧如初雪
Mochi	沙小弥	男	聪明伶俐的小大人，童真未泯却早慧如禅
Bellona	燕铮莺	女	声音洪亮吐字清晰，金戈铁马入梦来
Vincent	田叔	男	独特的沙哑烟嗓，一开口便道尽千军万马
Bunny	萌小姬	女	"萌属性"爆棚的小萝莉
Neil	阿闻	男	最专业的新闻主持人
Elias	墨讲师	女	学科严谨与叙事技巧兼具的女讲师
Arthur	徐大爷	男	被岁月和旱烟浸泡过的质朴嗓音
Nini	邻家妹妹	女	糯米糍一样又软又黏的嗓音
Seren	小婉	女	温和舒缓的声线，助你更快入睡
Pip	顽屁小孩	男	调皮捣蛋却充满童真
Stella	少女阿月	女	甜到发腻的迷糊少女音，"代表月亮消灭你"

注意

音色清单为当前开放范围，后续可能调整；方言/小语种音色暂不支持。自定义音色 ID 需另行开通。