用途:通过 ListenHub OpenAPI 把文本转成语音,覆盖短文本、多角色对话与长文本朗读。Base URL 为 https://api.marswave.ai/openapi,认证使用 Authorization: Bearer $LISTENHUB_API_KEY,调用前需确认该环境变量已设置。
主要能力: 一、快速合成 POST /v1/tts,适合约 1000 字以下单音色低延迟场景。请求含 text、speakerId,可选 format(默认 mp3)、sampleRate(默认 24000)、speed(默认 1.0,范围 0.5~2.0),响应为 MP3 二进制流。 二、多角色脚本合成 POST /v1/speech,适合播客、对话等。script 数组每项含 text 与 speakerId,响应返回 JSON 的 audioUrl 与 duration。 三、长文本流式合成 POST /v1/flow-speech/episodes,适合超 1000 字文章或提供 contentUrl 的场景。参数含 title、speakerId,content 与 contentUrl 二选一,mode 可选 direct 或 aiPolish(默认 direct)。返回 episodeId 与 status,需轮询 GET /v1/flow-speech/episodes/{episodeId},建议提交后等 30 秒,再每 10 秒轮询一次,直到 completed 或 failed。
音色:未指定时调用 GET /v1/speakers/list?language=zh 获取列表(含 name、speakerId、demoAudioUrl、gender、language),默认 chat-girl-105-cn(晓曼)。
用法示例: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
限制:以资料所述三接口为准,其它参数与限制暂未提供;错误处理涵盖 401、400、flow-speech failed 及网络错误。