MCPInstall

listenhub-tts

by smallnestMedia & Creative

使用 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"

Installs
430
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/smallnest/goal-workflow --skill listenhub-tts
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads listenhub-tts automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

默认音色

字段值
speakerIdchat-girl-105-cn
名称晓曼 dxqqq

三种合成模式

模式一：快速合成（短文本，单音色）

适用场景： 短文本（< 1000 字），单音色，需要低延迟

接口： POST /v1/tts

请求体：

{
  "text": "要合成的文本",
  "speakerId": "chat-girl-105-cn",
  "format": "mp3",
  "sampleRate": 24000,
  "speed": 1.0
}
参数类型必填说明
textstring是要合成的文本
speakerIdstring是音色 ID
formatstring否输出格式，默认 mp3
sampleRateint否采样率，默认 24000
speedfloat否语速，默认 1.0，范围 0.5 ~ 2.0

响应： 直接返回 MP3 二进制流（Content-Type: audio/mpeg）

调用示例：

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 /v1/speech

请求体：

{
  "script": [
    {
      "text": "你好，欢迎收听本期节目。",
      "speakerId": "chat-girl-105-cn"
    },
    {
      "text": "谢谢，今天我们来聊聊 AI。",
      "speakerId": "chat-boy-101-cn"
    }
  ],
  "format": "mp3",
  "sampleRate": 24000
}
参数类型必填说明
scriptarray是脚本数组，每项包含 text 和 speakerId
script[].textstring是该段文本
script[].speakerIdstring是该段的音色 ID
formatstring否输出格式，默认 mp3
sampleRateint否采样率，默认 24000

响应： JSON

{
  "audioUrl": "https://cdn.example.com/output.mp3",
  "duration": 12.5
}

调用示例：

curl -X POST "https://api.marswave.ai/openapi/v1/speech" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": [
      {"text": "你好，欢迎收听。", "speakerId": "chat-girl-105-cn"},
      {"text": "谢谢，我们开始吧。", "speakerId": "chat-boy-101-cn"}
    ]
  }'

模式三：长文本流式合成

适用场景： 长文本（> 1000 字），文章朗读，需要 AI 润色或分段处理

接口： POST /v1/flow-speech/episodes

请求体：

{
  "title": "文章标题",
  "content": "长文本内容...",
  "speakerId": "chat-girl-105-cn",
  "mode": "direct",
  "format": "mp3"
}
参数类型必填说明
titlestring是音频标题
contentstring否文本内容（与 contentUrl 二选一）
contentUrlstring否内容 URL（与 content 二选一）
speakerIdstring是音色 ID
modestring否direct（直接合成）或 aiPolish（AI 润色），默认 direct
formatstring否输出格式，默认 mp3

响应： JSON

{
  "episodeId": "ep_abc123",
  "status": "processing"
}

轮询获取结果：

GET /v1/flow-speech/episodes/{episodeId}

轮询策略：

  1. 提交后等待 30 秒
  2. 之后每 10 秒轮询一次
  3. 直到 status 变为 completed 或 failed

轮询响应：

{
  "episodeId": "ep_abc123",
  "status": "completed",
  "audioUrl": "https://cdn.example.com/output.mp3",
  "duration": 180.5
}
status 值说明
processing合成中，继续轮询
completed合成完成，audioUrl 可用
failed合成失败，查看 errorMessage

调用示例：

# 提交任务
curl -X POST "https://api.marswave.ai/openapi/v1/flow-speech/episodes" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "AI 技术趋势",
    "content": "长文本内容...",
    "speakerId": "chat-girl-105-cn",
    "mode": "direct"
  }'

# 轮询结果
curl "https://api.marswave.ai/openapi/v1/flow-speech/episodes/ep_abc123" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY"

音色列表查询

接口： GET /v1/speakers/list

查询参数：

参数类型必填说明
languagestring否筛选语言，如 zh（中文）、en（英文）

响应：

{
  "speakers": [
    {
      "name": "晓曼 dxqqq",
      "speakerId": "chat-girl-105-cn",
      "demoAudioUrl": "https://cdn.example.com/demo.mp3",
      "gender": "female",
      "language": "zh"
    }
  ]
}

模式选择逻辑

根据用户输入自动选择最合适的模式：

条件模式
文本 ≤ 1000 字，单音色模式一：/v1/tts
多角色脚本，需要不同音色模式二：/v1/speech
文本 > 1000 字，或需要 AI 润色模式三：/v1/flow-speech/episodes
用户提供 URL 作为内容来源模式三：/v1/flow-speech/episodes

如果用户明确指定模式，优先使用用户指定的模式。

用户交互

音色选择

当用户未指定音色时，使用 AskUserQuestion 展示音色列表：

请选择音色（默认：晓曼 dxqqq）：
A. 晓曼 dxqqq（女，chat-girl-105-cn）[默认]
B. [其他音色名称]（[性别]，[speakerId]）
C. ...

合成参数

可选询问：

  • 语速 speed（默认 1.0）
  • 输出格式 format（默认 mp3）
  • 长文本模式：direct 还是 aiPolish（默认 direct）
  • 输出文件路径（默认 ./output.mp3）

输出

  1. 将音频保存到指定路径（默认 ./output.mp3）
  2. 输出合成摘要：
    • 使用的模式
    • 音色名称和 ID
    • 音频时长
    • 文件大小
    • 文件路径

错误处理

  • 401 Unauthorized: 提示用户检查 LISTENHUB_API_KEY 环境变量
  • 400 Bad Request: 检查请求参数，向用户报告具体错误
  • flow-speech failed: 报告 errorMessage，建议用户重试或切换模式
  • 网络错误: 提示检查网络连接，建议重试

完整示例

用户输入： "把这段文字转成语音：今天天气真好，适合出去散步。"

执行流程：

  1. 检查 LISTENHUB_API_KEY ✓
  2. 文本长度 < 1000 字，单音色 → 选择模式一 /v1/tts
  3. 用户未指定音色 → 默认使用 chat-girl-105-cn（晓曼）
  4. 调用 API 合成
  5. 保存到 ./output.mp3
  6. 输出摘要

用户输入： "用晓曼的声音朗读这篇文章：article.md"

执行流程：

  1. 读取 article.md 内容
  2. 检查文本长度 > 1000 字 → 选择模式三 /v1/flow-speech/episodes
  3. 音色已指定：chat-girl-105-cn（晓曼）
  4. 提交合成任务
  5. 轮询直到完成
  6. 下载音频保存到 ./article.mp3
  7. 输出摘要

FAQ

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 listenhub-tts?

Run npx skills add https://github.com/smallnest/goal-workflow --skill listenhub-tts in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/listenhub-tts/ (personal) or .claude/skills/listenhub-tts/ (project).

Which AI agents can use listenhub-tts?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is listenhub-tts safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains listenhub-tts?

It is published by smallnest in smallnest/goal-workflow. It has 430 recorded installs.

More from smallnest/goal-workflow

View all →

smell

smallnest/goal-workflow

Detect software architecture bad smells, algorithmic complexity hotspots, and anti-patterns in a codebase. Produces a detailed markdown report identifying violations of architectural principles, design patterns, code quality, and performance complexity. Triggers on: smell, code smell, architecture smell, find anti-patterns, detect bad smells, complexity analysis, 代码坏味道, 架构坏味道, 反模式, 找出坏味道, 复杂度分析.

Code Quality & Workflow775 installs

prd

smallnest/goal-workflow

Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. After PRD is confirmed, use /prd-to-spec (optional) for technical design, then /to-issues to create implementable tickets. Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out, 写PRD, 需求文档, 需求分析, 规格说明.

Code Quality & Workflow534 installs

humanize-it

smallnest/goal-workflow

对指定文档进行去 AI 味的改写。自动选择最合适的人性化策略（humanizer-zh / humanize-chinese / technical-writing）， 迭代改写直到效果达标或迭代 42 次为止。适用于中文文本的去 AI 化处理，包括通用文章、技术文档、学术论文等。 Use when user says: "humanize this", "去AI味", "降AIGC", "人性化改写", "改成人话", "去除AI痕迹", "humanize document", "make text human-like", "去机器味", "降低AI率", "过AIGC检测"

Docs & Writing534 installs

insight-diagram

smallnest/goal-workflow

为任意项目生成 UML 图、架构图和流程图。分析代码库后让用户选择要生成的图表类型，使用 architecture-diagram skill 渲染为 HTML+SVG，保存到 docs/ 目录。适用于任何软件项目的文档可视化。

Docs & Writing524 installs

refactor

smallnest/goal-workflow

Expert code refactoring based on Martin Fowler's catalog — improve maintainability without changing behavior. Covers code smells, composing methods, moving features, organizing data, simplifying conditionals, method calls, and generalization. Triggers on: refactor, 重构, clean up, improve code, code smell, extract method, rename, simplify.

Code Quality & Workflow524 installs

modern-go

smallnest/goal-workflow

Modernize Go code by applying version-appropriate idioms and APIs (gofix-style transformations). Scans go.mod for the Go version, then transforms Go source files to use modern patterns—from Go 1.0 through 1.26+. Use when the user says "现代化","现代Go语言", "地道的", "idiomatic", "modernize", "modern-go", "update Go code", "gofix", or wants to upgrade Go idioms.

Productivity & Automation523 installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs