帮助与 FAQ

常见问题

API Key 相关

Q: 提示"API Key 未配置"怎么办？

首次使用时 AI 会自动检测并引导配置。如果跳过了配置流程，可以手动设置：

1. 打开 ListenHub API Key 设置页面
2. 创建或复制 API Key（格式为 lh_sk_ 开头）
3. 在终端中运行：export LISTENHUB_API_KEY="lh_sk_your_key_here"
4. 将上面这行添加到 ~/.zshrc 或 ~/.bashrc 中，使其永久生效

Q: 免费账号能使用 Skills 吗？

可以。所有用户均可在 API Key 设置页面 获取 API Key 并使用 Skills。

生成相关

Q: 生成播客或视频时等了很久还没完成？

正常情况下，播客需要 2-3 分钟，解说视频需要 3-5 分钟。如果超过 10 分钟仍未完成，可能是服务端繁忙。可以随时问 AI"好了吗"来查询状态，或者重新提交一次。

Q: 生成的内容质量不满意？

几个改善方向：

• 给更具体的主题描述（"AI 编程的三个核心范式转变"比"AI 编程"效果好）
• 指定模式：deep（深度长内容）或 quick（精炼短内容）
• 指定语言：在请求中明确"用中文"或"用英文"
• 使用两阶段播客模式，先审核文本稿再生成音频

Q: 可以用自己写的稿子生成播客吗？

可以。使用两阶段播客的阶段二功能，提供自定义脚本 JSON，直接生成音频。或者使用 Speech 多角色台词模式，精确控制每句台词的音色分配。

图片相关

Q: 参考图必须上传到图床吗？

是的。参考图需要一个可公开访问的 URL，本地文件路径无法使用。免费图床推荐：imgbb.com、sm.ms、postimages.org。上传后复制直接链接（通常以 .jpg 或 .png 结尾）。

Q: 生成的图片保存在哪里？

默认保存到 ~/Downloads 目录，文件名格式为 listenhub-{日期}-{时间}-{ID}.jpg。

音色相关

Q: 怎么查看可用的音色列表？

直接问 AI，比如"有哪些中文音色"或"查一下有没有洛天依的声音"。AI 会调用音色查询接口返回完整列表。

Q: 可以使用自己克隆的声音吗？

如果已经在 ListenHub 平台上完成了声音克隆，克隆音色会出现在可用音色列表中，可以直接使用。

常见错误

Error: Invalid JSON format

在使用 Speech 多音色脚本或两阶段播客的自定义脚本时，脚本内容必须是合法的 JSON 格式。确认文件结构为：

{
  "scripts": [
    { "content": "台词内容", "speakerId": "音色ID" }
  ]
}

curl: command not found 或 jq: command not found

Skills 运行依赖 curl 和 jq。大多数情况下 AI 会自动安装，如果没有，可以手动安装：

# macOS
brew install curl jq

# Ubuntu/Debian
sudo apt install curl jq

生成任务长时间卡在 "processing"

可能原因：服务端排队中，或网络超时。可以尝试：

1. 等待 1-2 分钟后再次查询状态
2. 如果持续超过 10 分钟，重新提交生成请求

通用排查

遇到异常时，优先重新执行一次安装命令。安装命令始终拉取最新版本，问题可能已经在新版本中修复：

npx skills add marswaveai/skills

万事问 AI

如果以上内容没有覆盖到遇到的问题，可以直接用自然语言向 AI 提问。AI 了解 ListenHub Skills 的全部能力和常见问题：

ListenHub 能做什么

联系支持

更多帮助请联系 support@marswave.ai。