用途：这是一个按 HTTP 状态码排查 ElevenLabs API 错误的快速诊断参考，适用于 TTS/STS 请求失败、鉴权或配额异常、并发限流等场景。
主要能力：先用连通性探测区分鉴权、配额与请求问题，再把观察到的状态码和响应体中的 detail.status 映射到对应修复动作。覆盖 401 invalid_api_key（密钥缺失、格式错误或已吊销）、401 quota_exceeded（月度字符额度用尽）、400 voice_not_found（voice_id 无效）、400 text_too_long（TTS 文本超过 5000 字符）、400 model_not_found（model_id 字符串错误）、429 too_many_concurrent_requests（超出套餐并发）、429 system_busy（服务端负载）、422 invalid_voice_sample（克隆音频格式或时长不合格），以及 WebSocket 静默失败（缺少 xi_api_key 或 eleven_v3）。
使用方式：先运行探测命令，例如 curl -s -w "\nHTTP %{http_code}" https://api.elevenlabs.io/v1/user -H "xi-api-key: ${ELEVENLABS_API_KEY}"；再用 jq 查看 character_count 与 character_limit，并用 GET /v1/voices 确认可用 voice_id。随后按状态码对照表执行修复，最后用调试清单复核密钥、配额、voice_id、model_id、请求大小、并发数，并查看 https://status.elevenlabs.io。长文本可分段并配合 previous_text/next_text 保持连贯；并发超限可用队列限制并发数。
限制：完整的分状态码载荷与修复代码位于 references/error-reference.md，本资料未提供其内容；具体套餐并发上限、模型 ID 列表与价格等事实暂未提供。400、401、404、422 通常不可重试，429 与 500+ 可退避重试。