技术支持与 FAQ

八、技术支持

1. 文档资源

• API 完整文档：
  • 中文：https://docs.marswave.ai/openapi-user.html
  • 英文：https://docs.marswave.ai/openapi-user-en.html
• 积分指南：https://listenhub.ai/zh/pricing
• 产品定价：https://listenhub.ai/zh/pricing

2. 联系方式

技术支持：

• 邮箱：support@marswave.ai

问题反馈： 遇到技术问题时，请提供以下信息：

• API 请求完整日志
• episodeId（如适用）
• 错误码和错误信息
• 预期行为与实际行为对比

3. 常见问题

Q: 如何获取 API Key？ A: 访问 API Keys 设置页面，需订阅 Pro、Max 或 Enterprise 套餐。

Q: 为什么返回 21007 错误？ A: API Key 无效。请检查：

• Authorization 头格式是否为：Bearer API_KEY
• API Key 是否正确复制
• API Key 是否已过期

Q: 积分不足怎么办？

A:

• 常规用户：升级套餐或购买额外积分
• Enterprise 套餐：联系客服

Q: 如何判断任务是否完成？ A: 轮询查询接口，当 processStatus 为 success 时表示完成。

Q: 支持哪些音频格式？ A:

• M3U8 流式音频（推荐播放）
• MP3 完整音频（推荐下载）

---

附录

A. 术语表

• RPM：Requests Per Minute，每分钟请求次数
• SSE：Server-Sent Events，服务器推送事件
• M3U8：HLS 流媒体格式
• Episode：单集，内容的基本单元
• Speaker：音频生成的核心参数，定义了单集的声学特性。每个 Speaker 包含以下关键属性：
  • SpeakerId：音色的唯一标识符
  • SpeakerName：音色的显示名称
  • Language：音色支持的语言类型

---

感谢使用 ListenHub OpenAPI！

如有任何问题，请随时联系我们：support@marswave.ai