ElevenLabs CLI 免费额度有多少？官方口径说清

ElevenLabs CLI 本身开源免费，不单独收钱；真正的额度在你的 ElevenLabs 账户里。按官方 API 计价页口径，免费档包含 v3 文字转语音 1 万字符、Flash/Turbo 模型 2 万字符、Scribe 语音转文字 4.5 小时等用量。本文把安装、登录、免费额度和省钱路径一次说清。

先说清楚：CLI 免费和账户额度是两回事

很多人把两个问题混在一起问，拆开看就明白了：

1. CLI 软件本身：官方开源，源码在 GitHub 的 elevenlabs/cli 仓库，安装、登录、管理 agent 配置这些操作不额外收费。
2. 账户额度：CLI 背后连着你的 ElevenLabs 账户，任何走模型的语音生成、转写都按账户套餐的额度体系计费。

所以「CLI 免费额度有多少」的准确答案是：额度取决于你账户的套餐档位，跟用不用 CLI 没有关系。

安装：认准官方渠道

官方文档推荐的安装方式（附带独立二进制）：

1. macOS（Homebrew）：brew install elevenlabs/tap/elevenlabs
2. Windows（Scoop）：先 scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket，再 scoop install elevenlabs
3. npm：npm install -g @elevenlabs/cli

装完终端里就有 elevenlabs 命令。一个提醒：npm 上搜 elevenlabs 会出现各种第三方包，认准 @elevenlabs/cli 这个官方 scope，别装错。

登录：OAuth 一步到位

1. 运行 elevenlabs auth login，会打开浏览器走 OAuth 授权，凭证验证后安全存储。
2. 凭证默认存进系统钥匙串（macOS 是 Keychain），无钥匙串环境会降级到配置目录下的 auth 文件，权限为 0600。
3. elevenlabs auth status 查看当前凭证来源，elevenlabs auth logout 移除。

CI/CD 场景不弹浏览器，官方给的方案是改用环境变量 ELEVENLABS_API_KEY 或 .env 文件，GitHub Actions 里配合 secrets 使用即可。

免费额度到底有多少（官方计价页口径）

官方 API 计价页给出的 Free / 按量付费档包含用量，整理如下：

数据抓取自官方计价页，2026 年 9 月。换算成感知：1 万字符 v3 大约够一篇短文的朗读配音，做产品 demo 绰绰有余，做批量有声内容远远不够。

用超了怎么办：三条省钱路径

1. 按量付费（Pay as you go）：官方支持预付充值，用多少扣多少，适合用量波动大的场景。
2. 订阅档位：Starter 6 美元/月起，Creator 22 美元/月（首月 11 美元），档位越高包含量越大；升级时旧档未用完的 credits 会滚入下一周期。
3. 创业扶持（Startup Grants）：官方项目，符合条件可申请 12 个月免费、共 3300 万字符的额度，这是被大多数人忽略的大额免费通道。

还有两个日常能省的：选 Flash/Turbo 系模型，单价是 v3 的一半；写文本时精炼字符数，TTS 按字符计费，少写一字就少扣一点。这类思路和通用的大模型省钱逻辑一致，可以参考站内的如何节省 token 开销。

CLI 里哪些操作真正烧额度

按官方文档，CLI 的核心定位是「agent 即代码」：在本地管理对话 agent 的配置文件，push 到 ElevenLabs 平台，再配合 CI/CD 自动部署，也支持从平台 pull 回本地。这类配置管理操作不产生语音生成，不按音频计费。真正消耗额度的是调用语音生成、转写这类模型能力时，按上面表格的单价从账户余额里扣。分不清 API 和客户端产品的计费边界，先读这篇API 和客户端到底有什么不同。

想了解 ElevenLabs 的语音能力全貌，先补两个基础概念：什么是 TTS和什么是 ASR。