ElevenLabs 免费 API 申请教程：每月 1 万 credits 语音合成与识别额度
免费额度
Free 计划每月 10,000 credits（约 10 分钟 TTS），含语音合成、语音识别、音效、Voice Design、音乐与图片；不含商用授权
注意事项
教程
ElevenLabs 的免费额度归属于 Free 计划，注册后即生效，全程不需要绑定信用卡，也不要求实名认证。
- 从定价页进入注册：打开
https://elevenlabs.io/pricing，找到 Free 计划一栏，点击该栏中的开始使用按钮，页面会跳转到账号创建流程。 - 选择注册方式：支持邮箱加密码注册，也可以直接用 Google 账号一键登录。邮箱注册需要到收件箱点击验证链接激活，没收到就翻一下垃圾邮件文件夹。
- 完成首次信息填写：首次登录会让你填写使用场景之类的简单问卷，按实际情况勾选即可，不影响额度发放；这一步不要求上传身份证件，也不要求填写支付方式。
- 确认额度到账：登录后进入控制台的用量（Usage）页面，可以看到 Free 计划每月赠送的 10,000 credits 及剩余量，具体数值与重置日期以控制台实际显示为准。
- 生成 API 密钥：在个人资料（Profile）里的 API Keys 区域创建密钥，完整密钥只在创建时显示一次，请立即复制到本地保存，页面关闭后无法再次查看。
- 了解免费层边界：额度按月刷新，但不含商用授权，仅限个人非商用测试；商用授权需要升级到 Starter 及以上套餐，声音克隆与部分专业音色同样属于付费能力，调用前先确认所选音色在免费层可用。
接口形态与地址
ElevenLabs 提供的是 REST 风格的语音接口，并非对话补全（chat completions）形态。所有请求的 base_url 为 https://api.elevenlabs.io/v1，鉴权通过请求头 xi-api-key 传递，而不是常见的 Authorization: Bearer。
常用端点：语音合成 /text-to-speech/{voice_id}，语音识别 /speech-to-text，音效生成 /sound-generation，账户用量查询 /user/subscription。
密钥与模型
先把密钥放进环境变量，避免写死在代码里：
export ELEVENLABS_API_KEY="your_api_key_here"模型通过请求体里的 model_id 指定，常用的有 eleven_multilingual_v2（多语种、质量优先）、eleven_turbo_v2_5（延迟更低）、eleven_flash_v2_5（速度优先的一档）。可用模型与音色清单分别调用 /models 和 /voices 获取，路径里的 voice_id 就从 /voices 的返回结果中复制。
一次语音合成调用
下面这条 curl 会把一段文本合成 mp3 并保存到本地，替换 voice_id 和文本即可直接运行：
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/VOICE_ID" \
-H "xi-api-key: $ELEVENLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello, this is a test.",
"model_id": "eleven_multilingual_v2",
"voice_settings": {
"stability": 0.5,
"similarity_boost": 0.75
}
}' \
--output output.mp3关键参数说明：text 是待合成文本，长度上限与扣费按字符折算 credits，具体规则以控制台实际显示为准；model_id 决定语种覆盖与响应延迟；voice_id 写在路径里，决定音色；voice_settings.stability 越低语调起伏越大，similarity_boost 越高越贴近原始音色。响应体直接是音频二进制流，用 --output 落盘保存，不指定 Accept 头时默认返回 audio/mpeg。
额度耗尽与限流的排查
典型表现：返回 401 且响应体中 detail.status 为 quota_exceeded，说明当期免费 credits 已用完；返回 429 表示触发了频率或并发限制；返回 401 并提示 invalid api key，则是密钥本身填错或已删除。
排查顺序建议：先调用 /user/subscription 查看剩余额度与重置日期；再核对请求头字段名是否写成了 xi-api-key；然后确认所用 voice_id 在免费层可用；最后检查是否短时间并发过多，必要时降低并发并加入重试退避。额度按月刷新，用完后不必重复注册，等待下个周期或升级付费套餐即可。
这个还能用吗？点一下告诉我们
只能从下方固定选项中选择，无法自由输入，避免垃圾信息与安全隐患。
留言区 0
真实访客可自由留言，提交后先经内容安全审核（本地 + 可选远程 API）再展示；违规内容会被拦截，不会出现在此处。示例留言均带「示例」标识，不冒充真实用户。