流式语音合成

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

注意

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

请求信息

请求 URI

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

请求头参数

请求头	必填	说明
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 填入请求体：

{
  "text": "要合成的文本",
  "voice_id": "音色名称或音色 ID"
}

如果不传 voice_id，接口将使用角色配置中的默认音色。

音色分类

音色来源	说明	详细列表
阿里云	当前开放的阿里云内置音色	查看阿里云音色
火山豆包	当前实测可用的火山豆包音色	查看火山豆包音色

选择顺序

1. 根据接入的语音供应商选择对应音色页面；
2. 复制目标音色的 voice_id；
3. 填入语音合成请求体并发起请求；
4. 以接口实际返回的音频流为准。

注意

音色清单为当前开放范围，后续可能调整；请求时请使用对应页面中的 voice_id。