listenhub-tts
使用 ListenHub API 将文本转换为语音（TTS）。支持三种模式：快速合成（/v1/tts）、 多角色脚本（/v1/speech）、长文本流式合成（/v1/flow-speech/episodes）。 音色未指定时自动获取音色列表供用户选择，默认使用 chat-girl-105-cn（晓曼）。 Use when user says: "tts", "text to speech", "语音合成", "文字转语音", "朗读", "生成语音", "生成音频", "转音频", "text to audio"
npx skills add smallnest/goal-workflow --skill listenhub-tts --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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.marswav
- API 信息
- 音色选择流程
- 用户已明确指定音色
- 用户未指定音色
- 默认音色
- 三种合成模式
- 模式一：快速合成（短文本，单音色）
- 模式二：多角色脚本合成
- 模式三：长文本流式合成
- 音色列表查询
- 模式选择逻辑
- 用户交互
- 音色选择
- 合成参数
curl -X POST "https://api.marswave.ai/openapi/v1/tts" \
curl -X POST "https://api.marswave.ai/openapi/v1/speech" \
GET /v1/flow-speech/episodes/{episodeId}
curl -X POST "https://api.marswave.ai/openapi/v1/flow-speech/episodes" \
curl "https://api.marswave.ai/openapi/v1/flow-speech/episodes/ep_abc123" \What does the listenhub-tts skill do?
使用 ListenHub API 将文本转换为语音（TTS）。支持三种模式：快速合成（/v1/tts）、 多角色脚本（/v1/speech）、长文本流式合成（/v1/flow-speech/episodes）。 音色未指定时自动获取音色列表供用户选择，默认使用 chat-girl-105-cn（晓曼）。 Use when user says: "tts", "text to speech", "语音合成", "文字转语音", "朗读", "生成语音", "生成音频", "转音频", "text to audio"
How do I install it?
Run `npx skills add smallnest/goal-workflow --skill listenhub-tts --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From smallnest/goal-workflow, a repository with 199 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.