文档 / 账号与支持

常见问题排查

按你遇到的现象直接找对应小节。

一、提示类问题（弹出了错误提示）

「积分余额不足」

赠送积分和充值积分都用完了。三个选择：

充值——$5 起，到账 3,800 积分，有效期 1 年。
换个便宜的音色——最便宜和最贵的档位差约 42 倍。腾讯精品、百度基础只要 5 积分/千字符，豆包小模型约 4。见八家品牌总览。
填自己的 API Key——走你自己的账号，一分积分都不扣。

先确认是不是选错了档位：在 TTS 设置里看一眼「约 N 积分 / 千字符」。如果显示的是 104 或 209，说明你选中的是全站最贵的那几档。

「商用系统 API 需升级 Pro 后使用」

云端 AI 音色需要有效订阅。三个选择：

订阅任一档（怎么选）
用系统自带语音——免费、不限次数、不需要登录
填自己的 API Key

「请先登录」/「请重新登录」/「当前页面账号与登录会话不一致」

第三条最容易让人困惑：它的意思是你页面上显示的账号，和实际登录凭证对应的账号不是同一个。常见于用了多账号切换、或者登录状态过期之后。

解决办法都一样：退出登录，重新登录一次。

「单次文本不能超过 N 字」

朗读：单次 500 字（自己的 Key 是 4,000 字）。正常情况下 Soniva 会自动分段，不该报这个错—— 如果报了，多半是文本里有超长的无标点段落，切不开。手动加几个标点或换行即可。
翻译：免费档单次 3,000 字，订阅用户 2 万字。分段发送即可。

「请求过于频繁」

触发了频率限制（翻译是每分钟 10 次，用自己的 Key 是 20 次）。等一分钟再试。

「本月订阅翻译额度已用完」

翻译额度是按品牌分别计的。换一个翻译品牌（DeepSeek / 阿里云 / 火山方舟 / 智谱 GLM）就能继续用另一个品牌的额度，或者填自己的 Key。见翻译功能指南。

二、点了没反应 / 没声音

按这个顺序排查：

检查标签页是否被浏览器静音——右键标签页看有没有"取消静音"。
检查系统音量和输出设备——尤其是插着耳机/连着蓝牙音箱的时候。
换一个音色试试——比如从当前音色切到系统自带语音。如果系统语音能出声、云端音色不能，说明问题在网络或上游，不在你的设备。
刷新页面。

正常情况下不该完全没声音：Soniva 有三级容错—— 云端音色失败会自动退到阿里云兜底音色，再失败会退到你设备自带的系统语音。所以"完全静默"通常是设备/浏览器侧的问题，而不是 Soniva 侧的。

三、声音突然变了

这是三级容错触发了，不是 bug。你选的云端音色请求失败（上游超时、限流或临时故障）， Soniva 自动切到了兜底音色，先保证你能把内容听完。

过几分钟再试，或者换一个品牌。

四、长文读到一半有停顿

超过单次上限的文本会被自动切成多段依次朗读，段与段之间有极短的衔接。上游响应慢时会变得明显。

减少停顿：填自己的 API Key（单次上限从 500 字提到 4,000 字，段数少 8 倍），或避开豆包小模型（它每段只有 280 字，切得最碎）。

五、扣的积分跟我预想的不一样

先看这三条最常见的原因：

选中的档位比你以为的贵。 尤其是腾讯云—— 它的音色列表默认把最贵的超自然档排在最前面，随手点第一个就是 104 积分/千字符，而往下翻找到 101 开头的精品音色只要 5。
MiniMax 的汉字算 2 个字符。 全站唯一一家。
百度和豆包小模型是按调用次数计费的。 读很短的内容时，折算下来的"每千字单价"会比费率表上高——这是按次计费的特性。读得越长越接近表上的数字。

每一笔扣费都能在积分流水里查到明细。

六、换了设备/浏览器，历史记录不见了

先确认你登录了。 会话同步需要登录（但不需要订阅）。未登录时会话只存在当前浏览器本地，换个浏览器就看不到。

如果登录了还是看不到，见账号与同步。

七、网络相关

如果提示网络连接失败或超时：

检查防火墙/代理是否拦截了第三方语音 API 域名
公司网络、校园网常有此类限制，换个网络试试
国际品牌（ElevenLabs / 微软 / Cartesia）在部分网络环境下更容易超时，可以先换成国内品牌验证是不是网络问题

还是没解决

发邮件到 soniva.cde@gmail.com，请附上：

你在做什么操作（读文本 / 翻译 / 充值……）
选的品牌和音色
完整的错误提示文字（截图最好）
大概的发生时间