ElevenLabs 套餐额度查询与只读 API Key 接入教程

直接在官方控制台查看套餐

1. 打开 Subscription 并确认当前账号/工作空间，记录本周期套餐用量和上限，不查看或分享 Secret。
2. 将套餐、结转、PAYG、Key 限额分别核对；总可用 credits 不一定等于此接口推导余量。
3. 比较成功查询时间与官方重置日期。未返回日期、付款待处理或接口不可用时保留未知，直接向官方核实，不付费测试。

在 Quota Monitor 中接入 ElevenLabs · 套餐额度

1. 01

   确认账号、工作空间和要查的套餐

   在下方官方 Subscription 页面登录您实际使用的 ElevenLabs 账号，确认所选工作空间和套餐。分开查看套餐用量、结转和 PAYG，先记下本周期计数及重置时间，别记录或发送任何 Key。

   此连接不是现金钱包，也不读取所有产品剩余额度。若仅需 PAYG 余额、专属地区主机或私有部署，请手动查看官方账务；无需充值、升级套餐或生成媒体来测试。

   打开官方 Subscription（在新标签页打开）
2. 02

   进入同一工作空间的 API Keys

   打开下方官方 Developers → API Keys 入口；旧 Settings API Keys 链接会转到此页。确认账号/工作空间未切换，准备新的独立监控 Key，名称可用 QuotaMonitorReadOnly。

   个人 Key 继承所属用户的工作空间访问，创建需要 Full Seat；已有多座位客户可由现有管理员管理服务账号。没有此权限时先请负责人确认或手动查账，不为了监控购买席位或提高用户权限。

   打开 ElevenLabs API Keys（在新标签页打开）
3. 03

   只启用 User 的读取权限

   创建独立 Key 时保持 Restrict Key 开启，将 User 设为 Read，对应官方 user_read；其他功能保持无访问，不选 Read and Write、user_write、生成或工作空间管理。Key 的 credit quota 只是 Key 调用上限，不是本连接展示的套餐上限；不要改现有业务 Key。

   下方是官方服务账号创建接口支持的最小 JSON 请求体，只供已有服务账号的管理员在自己的安全工具中使用，目标路径和认证按官方文档配置；个人 Key 使用上方 UI，无需粘贴 JSON。本站不创建 Key 或修改权限。该只读 scope 仍可读取用户信息；无法接受时选择手动查询。

   已有服务账号的最小创建请求体 · 个人 Key 用 UI

   复制 JSON

   {
     "name": "QuotaMonitorReadOnly",
     "permissions": ["user_read"]
   }

   复制的是完整 JSON，不含密钥或账号信息。

   官方服务账号 Key 创建字段（在新标签页打开）
4. 04

   私下保存完整 Key 并设置轮换计划

   在创建时私下保存完整 Secret，官方之后只显示名称和末四位。不要把 Key ID、请求头、密码、Cookie 或截图当凭据，也不要发送到聊天或 MCP 参数。丢失时创建新的监控 Key，不撤销其他客户端的 Key。

   个人 Key 可通过 Expire After 设置到期，按您的安全要求选择并在到期前轮换；服务账号 Key 目前不设到期。若 Key 有 IP allowlist，必须与实际服务端出口匹配；无法确认时不要猜测、扩大网络权限或让本站更改供应商配置。

   官方 Key 到期与限制说明（在新标签页打开）
5. 05

   在 Quota Monitor 中添加连接

   打开目标项目，添加供应商连接并选择「ElevenLabs · 套餐额度」，填写可识别的连接名，将新 Secret 粘贴到遮蔽输入框并保存。MCP 用户只通过安全输入页面录入；帮助抽屉无需读取凭据。

   只填写 Key，不加 xi-api-key 或 Bearer，不提交 JSON、账号密码或自定义 API 地址。本站加密存储，列表只显示末四位；套餐不是美元监控，因此没有币种切换、资金预算或 daily burn 配置。

6. 06

   等待成功同步并核对原始计数

   等待首次同步或使用现有刷新入口，确认成功查询时间更新。卡片显示已用、上限、推导余量与下次重置；失败时显示的旧计数和旧时间不代表新查询成功。

   例 character_count=1000、character_limit=10000，planQuota.remaining=9000 credits；已用 12000、上限 10000 时剩余为 0、overage=2000 credits，不是欠款金额。只执行固定 GET，不生成内容、不充值或更改套餐。

   查看官方套餐响应字段（在新标签页打开）
7. 07

   对账重置时间，不补算其他额度

   回到同一工作空间的 Subscription，比较同一周期的已用和上限。next_character_count_reset_unix 转成 UTC 显示；为空或缺失时显示未返回，不从 billing_period 推算。付款后更新可能短暂延迟，先核对时间与套餐范围。

   PAYG、结转、不同模型的字符折扣和 Key 限额可能让控制台总可用量不同；只对比这两个官方套餐计数。不要用总 credits 反推充值金额或把共享套餐按 Key/本站项目相加。

   打开官方 Subscription 对账（在新标签页打开）
8. 08

   安全轮换并处理到期或失权

   需要更新时在同一工作空间创建同样仅 user_read 的监控 Key，通过本站连接的安全凭据更新入口替换，等新的成功查询后再在官方页面删除仅旧监控 Key。不要撤销其他应用凭据或给新 Key 复制生成权限。

   401 时核对完整 Secret、到期、撤销和所属用户访问；403 检查读取权限及 IP allowlist，429 等待退避。只反馈错误码与时间，不提供 Key；持续失败请手动查看官方套餐或联系支持，不提高为管理员权限。

   回到官方 API Keys（在新标签页打开）

Quota Monitor 读取的 ElevenLabs · 套餐额度 数据范围

• 官方将旧称 characters 改称 credits，实际每文本字符消耗依模型而异；不是可提现现金、美元价值或模型调用次数。只展示认证套餐计数，不从价格表估算余额，不从是否有余量判断能否调用模型。
• PAYG 充值、未体现在这两个计数器的结转、Key 自定义限额、超额费用及产品/Agent 专属权限均不推断或相加。套餐超用单独展示，不代表应付金额；同一套餐可被多个 Key/本站项目共用，不能重复加总。
• 只请求全球 api.elevenlabs.io 固定主机，不接收账户/项目/Key 过滤或自定义地区地址。缺失计数、错误与同步失败保留旧快照和时间，不把 null 改成零。没有货币预算、资金/耗尽天数提醒或付费测试；重置日期未知时不按月推算。
• Dashboard 展示最近一次成功的套餐额度或消费上限快照。刷新不能消除上游报告延迟；失败后保留的旧值和时间不是新结果，也不是钱包余额。

ElevenLabs · 套餐额度 常见问题与排查

401 或凭据拒绝怎么办？

确认是完整 Secret 而不是 Key ID/请求头，检查 Expire After、撤销及用户工作空间访问；再核对是否仅启用 user_read。不要提供 Cookie 或开启全部权限来排错。

403 或权限不足怎么办？

由已有负责人在 Restrict Key 下核对 User: Read 和服务端 IP allowlist。只读也可能暴露用户信息；不接受则手动查账，不授予管理或生成功能。

为什么与总剩余 credits 或 Key 限额不同？

这里只用 character_count 与 character_limit 推导套餐余量。PAYG、未体现在计数中的结转、单 Key 限额和产品权限独立，不相加、不按价格估算美元。

重置时间为空或年度账单怎么办？

next_character_count_reset_unix 为 null/缺失即未知，refreshPeriod 未知也保留 null。付款周期不等于刷新周期，不能一律每月 1 日或每年推算；以官方账户实际提示为准。

显示超用、旧计数或 429/5xx 怎么办？

超用是 credits 计数而非欠款；0 余量不能保证模型被阻断。429 等待退避，5xx 或格式错误保留上次成功快照；检查成功时间，不把旧数据显示成新查询。

是否会调用生成接口或改变套餐？

不会。固定全球 GET https://api.elevenlabs.io/v1/user/subscription，不调用收费模型、支付、Key 管理或权限写入，也不携带凭据跟随重定向。真实账号和后台操作仍待用户测试。

ElevenLabs · 套餐额度 官方资料

• 官方套餐查询与字段（在新标签页打开）
• 官方认证与限制（在新标签页打开）
• 官方 Developers API Keys 操作（在新标签页打开）
• 官方 Key 到期与服务账号权限模型（在新标签页打开）
• 官方服务账号 Key 最小请求体（在新标签页打开）
• 官方 user_read 权限枚举（在新标签页打开）
• 官方套餐计量、结转与 PAYG 边界（在新标签页打开）

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。