您点击了生成按钮，却收到错误提示，或者加载动画停止后没有产生任何音频。本页面介绍最常见的原因以及对应的解决方法。请从头开始逐步排查。
快速检查清单
请先完成以下检查。大多数问题属于以下四种情况之一：
- 积分不足
- 语音无效或缺失
- 文本超出所选模型的长度限制
- 网站未连接到 TTSWP
每种情况都会在错误弹窗中显示具体提示信息。请仔细阅读提示内容，再进行下一步操作。
原因 1：积分不足
错误提示： "Insufficient credits" 或 "You have run out of credits"
原因： 您的 TTSWP 月度积分已用完，没有可用的充值余额，也未连接 ElevenLabs 自带密钥（BYOK）。
解决方案：
- 等待月度积分重置（适用于付费套餐用户）。重置日期可在 文字转语音 → 我的套餐与积分 页面查看。
- 购买积分充值包。
- 连接您的 ElevenLabs API 密钥 以获取额外积分。
- 升级您的套餐。
原因 2：语音无效或缺失
错误提示： "The selected voice is no longer available on your ElevenLabs account. Please pick a different voice."
原因： 您设置为默认语音的音色已从 ElevenLabs 账户中移除。通常发生在克隆语音被删除，或语音 ID 存储有误的情况下。
解决方法：
- 前往 文字转语音 → 语音。
- 点击顶部栏中的 刷新语音。
- 从列表中选择其他语音。
- 点击 选择。
- 重新生成文章音频。
原因 3：文本超出模型长度限制
错误提示： "This text is longer than ElevenLabs accepts for this model. Please shorten it or pick a different model."
原因： 每个 ElevenLabs 模型都有单次请求的字符上限。Flash 和 Turbo v2.5 支持最多 40,000 个字符，Multilingual v2 仅支持 10,000 个字符，Eleven v3 仅支持 3,000 个字符。您的文章长度超出了所选模型的限制。
解决方案：
- 在语音页面切换到字符上限更高的模型
- 将文章拆分为较短的段落，并使用多个短代码
- 使用
no-audio类或 CSS 选择器排除部分内容
请参阅 选择语音 中的模型限制对照表。
原因 4：网站未连接
症状： 概览页面显示紫色的连接卡片，而非您的积分信息。
解决方法： 请先 连接您的网站。未建立连接时，音频生成始终会失败。
其他较少见的原因
ElevenLabs 自带密钥（BYOK）无效
错误： "TTS synthesis failed: Invalid API key"
解决方法： 请参阅 连接您自己的 ElevenLabs 密钥 并更新密钥。
网络超时
错误： "TTS synthesis failed: Operation timed out"
原因： 文本过长，或与 ElevenLabs 之间的网络路径较慢。
解决方法：
- 重试一次。临时性超时通常在下次尝试时自行解决。
- 如果问题持续出现，请尝试使用速度更快的模型（Flash v2.5）并缩短文本长度。
订阅付款问题
错误： "Your subscription has a failed or incomplete payment."
原因： 您的 ElevenLabs 订阅存在逾期未付的账单。此问题仅在使用付费 ElevenLabs 账户的 BYOK 模式时出现。
解决方法： 登录 elevenlabs.io 并完成付款。
语音与模型语言不匹配
错误： "Model X does not support language_code Y"
原因： 并非每个模型都支持所有语言。3.1.7 版本之后，由于对 WordPress 语言代码进行了标准化处理，此问题已较少出现。
解决方法： 在语音页面选择其他语言，或将模型切换为支持大多数主流语言的 Flash v2.5。
如何查看错误提示
从文章列表触发生成失败时，TTS 列会显示一个小型错误图标。将鼠标悬停在图标上即可查看提示信息。您也可以在 我的统计 → 最近活动 中查看近期操作日志。
如果错误提示内容不明确，请复制该提示并在本页查找，或前往 支持中心 获取帮助。