listenhub-tts

# ListenHub TTS: 文本转语音 使用 ListenHub OpenAPI 将文本转换为语音。支持三种合成模式，覆盖从短文本到长文本的全场景。 ## API 信息 - **Base URL:** `https://api.marswave.ai/openapi` - **认证:** `Authorization: Bearer $LISTENHUB_API_KEY`（从环境变量读取） - **前置检查:** 调用任何 API 前先确认 `LISTENHUB_API_KEY` 环境变量已设置，未设置则提示用户配置 ## 音色选择流程 ### 用户已明确指定音色 直接使用用户指定的 speakerId，跳过选择流程。 ### 用户未指定音色 1. 调用 `GET /v1/speakers/list?language=zh` 获取可用音色列表 2. 按 AskUserQuestion 展示音色列表供用户选择，格式如下： - 默认选中 `chat-girl-105-cn`（晓曼 dxqqq） - 列表展示：`{name}（{gender}，{speakerId}）` - 附带每个音色的 demoAudioUrl 供参考 3. 用户确认后使用选定的 speakerId ### 默认音色 | 字段 | 值 | |------|-----| | speakerId | `chat-girl-105-cn` | | 名称 | 晓曼 dxqqq | ## 三种合成模式 ### 模式一：快速合成（短文本，单音色） **适用场景：** 短文本（< 1000 字），单音色，需要低延迟 **接口：** `POST /v1/tts` **请求体：** ```json { "text": "要合成的文本", "speakerId": "chat-girl-105-cn", "format": "mp3", "sampleRate": 24000, "speed": 1.0 } ``` | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | text | string | 是 | 要合成的文本 | | speakerId | string | 是 | 音色 ID | | format | string | 否 | 输出格式，默认 `mp3` | | sampleRate | int | 否 | 采样率，默认 `24000` | | speed | float | 否 | 语速，默认 `1.0`，范围 `0.5 ~ 2.0` | **响应：** 直接返回 MP3 二进制流（`Content-Type: audio/mpeg`） **调用示例：** ```bash curl -X POST "https://api.marswave.ai/openapi/v1/tts" \ -H "Authorization: Bearer $LISTENHUB_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "你好世界", "speakerId": "chat-girl-105-cn"}' \ -o output.mp3 ``` ### 模式二：多角色脚本合成 **适用场景：** 多角色对话、播客、有声书片段，需要不同音色交替朗读 **接口：** `POST ...