常见问题 #
账户相关 #
如何注册 ElevenLabs 账户？ #
text
步骤：
1. 访问 https://elevenlabs.io
2. 点击 "Sign Up"
3. 选择注册方式：
- Google 账户登录
- 邮箱注册
4. 完成验证
忘记密码怎么办？ #
text
解决方法：
1. 访问登录页面
2. 点击 "Forgot Password"
3. 输入注册邮箱
4. 查收重置邮件
5. 设置新密码
如何更改订阅计划？ #
text
步骤：
1. 登录账户
2. 进入 "Subscription" 页面
3. 选择新计划
4. 确认更改
注意：
├── 升级：立即生效
└── 降级：下个周期生效
API 相关 #
API Key 在哪里获取？ #
text
步骤：
1. 登录 ElevenLabs
2. 点击右上角头像
3. 选择 "Profile Settings"
4. 找到 "API Key" 部分
5. 点击 "Create API Key"
安全提示：
├── API Key 只显示一次
├── 使用环境变量存储
└── 不要提交到版本控制
为什么 API 返回 401 错误？ #
text
可能原因：
├── API Key 无效或过期
├── API Key 格式错误
├── Header 设置错误
└── 账户被暂停
解决方案：
├── 检查 API Key 是否正确
├── 确认 Header 格式
│ - xi-api-key: your_key
│ - 或 Authorization: Bearer your_key
└── 联系支持团队
如何处理速率限制？ #
text
错误代码：429 Too Many Requests
解决方案：
┌─────────────────────────────────────────────────────────────┐
│ │
│ 1. 等待后重试 │
│ └── 检查 Retry-After Header │
│ │
│ 2. 实现指数退避 │
│ └── 1s → 2s → 4s → 8s... │
│ │
│ 3. 升级计划 │
│ └── 获得更高的速率限制 │
│ │
│ 4. 优化请求 │
│ └── 减少不必要的请求 │
│ │
└─────────────────────────────────────────────────────────────┘
如何处理配额用尽？ #
text
错误信息：quota_exceeded
解决方案：
├── 检查使用量：GET /v1/user/subscription
├── 等待下月重置
├── 升级计划
└── 购买额外额度（如支持）
语音相关 #
如何选择合适的语音？ #
text
选择建议：
┌─────────────────────────────────────────────────────────────┐
│ │
│ 有声书/播客：Rachel, Josh │
│ ├── 温暖、专业 │
│ └── 适合长时间收听 │
│ │
│ 广告/营销：Domi, Arnold │
│ ├── 有力、吸引人 │
│ └── 适合短内容 │
│ │
│ 教育/教程：Antoni, Adam │
│ ├── 清晰、标准 │
│ └── 适合学习内容 │
│ │
│ 游戏/动画：Elli, Sam │
│ ├── 年轻、活力 │
│ └── 适合娱乐内容 │
│ │
└─────────────────────────────────────────────────────────────┘
语音克隆需要多少音频？ #
text
即时克隆：
├── 最少：1 分钟
├── 推荐：2-5 分钟
└── 质量要求：清晰、无噪音
专业克隆：
├── 推荐：30+ 分钟
├── 内容：多样化
└── 质量要求：高质量录音
克隆语音效果不好怎么办？ #
text
优化建议：
┌─────────────────────────────────────────────────────────────┐
│ │
│ 音频质量： │
│ ├── 使用高质量录音 │
│ ├── 确保安静环境 │
│ └── 避免压缩音频 │
│ │
│ 样本内容： │
│ ├── 增加样本时长 │
│ ├── 包含不同情感 │
│ └── 多样化句子结构 │
│ │
│ 参数调整： │
│ ├── 调整 stability 参数 │
│ ├── 尝试 similarity_boost │
│ └── 使用专业克隆 │
│ │
└─────────────────────────────────────────────────────────────┘
如何获得更好的语音效果？ #
text
语音设置建议：
稳定场景（新闻、教程）：
├── stability: 0.6-0.8
├── similarity_boost: 0.75
└── style: 0.1-0.2
表现力场景（游戏、动画）：
├── stability: 0.3-0.5
├── similarity_boost: 0.7
└── style: 0.5-0.7
平衡场景（有声书、播客）：
├── stability: 0.5
├── similarity_boost: 0.75
└── style: 0.3
文本处理 #
文本长度有限制吗？ #
text
限制说明：
├── 单次请求：5000 字符
├── 长文本：需要分段处理
└── 流式 API：支持更长文本
建议：
├── 长文本分段处理
├── 使用流式 API
└── 合并音频文件
如何处理特殊字符？ #
text
建议：
├── URL：转换为文字描述
├── 数字：转换为文字
├── 缩写：展开为完整形式
└── 代码：跳过或描述
为什么语音输出有停顿？ #
text
可能原因：
├── 文本中有标点符号
├── SSML 标签影响
├── 网络延迟
└── 模型处理
解决方案：
├── 检查文本格式
├── 优化网络连接
└── 使用 Turbo 模型
技术问题 #
WebSocket 连接断开怎么办？ #
text
解决方案：
┌─────────────────────────────────────────────────────────────┐
│ │
│ 1. 实现自动重连 │
│ ├── 监听 close 事件 │
│ └── 延迟后重新连接 │
│ │
│ 2. 心跳保持 │
│ ├── 定期发送心跳 │
│ └── 检测连接状态 │
│ │
│ 3. 错误处理 │
│ ├── 捕获错误事件 │
│ └── 记录日志 │
│ │
└─────────────────────────────────────────────────────────────┘
如何处理音频延迟？ #
text
优化建议：
├── 使用 Turbo 模型
├── 降低音频质量要求
├── 使用流式处理
├── 优化网络连接
└── 使用就近服务器
Python SDK 安装失败？ #
text
常见问题：
├── Python 版本不兼容
│ └── 需要 Python 3.8+
├── pip 版本过旧
│ └── pip install --upgrade pip
├── 网络问题
│ └── 使用国内镜像
└── 依赖冲突
└── 使用虚拟环境
计费相关 #
字符是如何计算的？ #
text
计算规则：
├── 所有文本内容
├── 标点符号
├── 空格
└── 特殊字符
不计入：
├── SSML 标签
└── 多余空白
如何查看使用量？ #
python
# API 查询
user = client.user.get()
print(f"已使用: {user.subscription.character_count}")
print(f"总额度: {user.subscription.character_limit}")
配额何时重置？ #
text
重置规则：
├── 按月重置
├── 重置日期：订阅日期
└── 可在账户页面查看
其他问题 #
支持哪些语言？ #
text
支持语言（32+）：
├── 中文（普通话、粤语）
├── 英语（多种口音）
├── 日语
├── 韩语
├── 法语
├── 德语
├── 西班牙语
├── 意大利语
├── 葡萄牙语
├── 俄语
├── 阿拉伯语
├── 印地语
└── 更多...
可以商业使用吗？ #
text
商业使用许可：
├── Free 计划：需要署名
├── 付费计划：允许商业使用
└── Enterprise：完全商业许可
如何联系技术支持？ #
text
支持渠道：
├── 帮助中心：help.elevenlabs.io
├── 邮件：support@elevenlabs.io
├── Discord 社区
└── Enterprise：专属客户经理
下一步 #
最后更新：2026-04-05