教程更新
依据当前官方 v3 文档实现，真实账户仍待验收。请自行核对 Key 创建、权限、钱包范围与金额；自动测试和上线不等于真实对账通过。
- 所需凭据
- HeyGen API Key
- 监控币种
- USD · 美元
- 可以看到什么
- API 预付钱包余额 · USD
- 固定 GET https://api.heygen.com/v3/users/me，要求 billing_type=wallet 且 wallet.currency=usd，直接读取 wallet.remaining_balance（scope=account）。remaining_balance=42.5 即 $42.5，不除以 60 或 100，不再次扣消费。
不提供 Key，怎样手动查看 HeyGen 余额？
- 登录官方 API 平台并确认实际计费账户/工作空间。
- 在账户计费区域查看 USD 预付余额；不要把网页订阅 Credits、企业 Credits 或后付费上限当成美元钱包。
- 记录币种与时间。手动检查不需要向 Quota Monitor 或任何人提供 Key；是否充值由账户所有者自行决定。
在 Quota Monitor 中接入 HeyGen
确认 API 账户与预付钱包
打开下方 HeyGen API 平台，用实际承担 API 费用的账户登录。若使用团队，先切换到业务所用工作空间，再查看账户的计费/余额区域，记录币种、金额和时间。
完成后检查：目标是美元预付钱包，不是网页订阅的 Credits。若仅有企业 Credits 或后付费额度，请停在手动查看步骤，不为监控而切换套餐或充值。
打开 API Keys 并创建专用 Key
打开下方 API keys 页面，确认仍是同一账户/工作空间，使用页面的创建功能生成供 Quota Monitor 使用的独立 Key。支持名称时填写 Quota Monitor，支持到期时间时设置合适期限。
完成后检查：这是一把新监控 Key，不覆盖或轮换正在用于生产的业务 Key。页面没有创建入口时请账户管理员处理，不借用登录 Cookie。
只授予 account:read 权限
在 Key 的权限配置中选择自定义权限，仅启用 account:read 并保存。此权限对应 GET /v3/users/me；不要启用生成、写入权限或全权限 *:*。界面名称可能调整，以实际保存的 scope 为准。
完成后检查：Key 权限为 account:read，而不是覆盖所有读取接口的 *:read。官方未提供本场景可直接粘贴的 IAM 策略；不伪造权限 JSON。若找不到自定义权限，先手动查余额并联系 HeyGen 支持。
安全保存完整秘密值
将新 Key 保存在密码管理器，仅复制秘密值；不要附带 X-Api-Key:、Bearer、引号、空格或掩码。用官方 API Key 页面检查已保存权限，必要时可由你自己的安全工具读取 GET /v3/api_keys/self 核对 scope_mode=custom 和 scopes。
完成后检查：没有把 Key 放入聊天、截图、工单、网址或 MCP 参数。权限自查端点不由本站调用；account:read 虽然不执行生成，但会返回个人资料，仍应保护 Key。
在 Quota Monitor 的项目中添加连接
回到目标项目，添加供应商连接并选择 HeyGen（USD 预付钱包），填写便于识别的名称，将 Key 粘贴到遮蔽输入框并保存。使用 MCP 时由安全录入链接进入该页面，不把 Key 发给 agent。
完成后检查：连接属于正确项目，货币为 USD。不要填写自定义 API URL、上游项目 ID 或 Key ID；同一账户的其他项目可引用连接，但不会产生独立钱包。
等待首次同步并确认查询成功
等待首次自动同步，或手动查询一次。成功后应显示 API 钱包余额和新的查询时间；遇到刷新冷却时等提示结束，不连续点击。
完成后检查：旧金额可能在失败时保留，要同时查看同步状态与时间。null、字段缺失、权限错误或不支持的账务类型不会被展示为零余额。
按同一账户、时间和单位对账
回到同一 HeyGen API 平台账户，比较美元预付余额与卡片。例如 remaining_balance=42.5 应为 $42.5；不是旧版 quota 秒数，不除以 60，也不拿消费上限或 auto_reload 阈值比较。
完成后检查：REST/MCP 的 heygenBalance.balance 同卡片一致，billingType=wallet、scope=account。记录首次查询与控制台时间；若有消费在途，稍后重查，不手动估算补差。
管理余额、轮换与完成真实验收
余额不足时通过卡片的官方平台按钮打开 HeyGen，核对账户后由有付款权限的人决定是否补款。本站不充值、不修改自动充值。轮换时先创建另一把 account:read Key，安全更新连接并核对成功，再撤销旧监控 Key。
完成后检查：移除项目关联或删除本站连接不会撤销官方 Key。请验收上述流程和金额，反馈仅含脱敏错误码、时间和差异，不提供 Key、个人资料或完整响应。
Quota Monitor 读取的 HeyGen 数据范围
- 仅支持 API Key 对应的 USD 预付钱包。Enterprise 的 currency=credits、OAuth 网页订阅 subscription 和 usage_based 后付费均不支持，不把这些额度换算成美元。
- Key 决定上游账户/工作空间上下文，不能额外填写组织、项目或 Key 筛选。同一个钱包被多个本站项目引用时，不重复相加。
- 只存储精确余额与账务类型。用户名、邮箱、姓名、自动充值设置均丢弃；REST/MCP 的 heygenBalance.balance 与卡片使用同一金额。
- 查询只发出一个无缓存 GET，禁止重定向，不调用模型、管理 Key、充值或更改 auto_reload。官方 auto_reload 阈值不是账户余额。
- null 或缺失不是零，失败保留上次成功金额和时间。零与负余额原样保留；查询时间不代表结算保证，正余额也不保证模型请求能运行。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
HeyGen 常见问题与排查
- 401：Key 被拒绝？
- 确认 Key 来自 platform.heygen.com/api-keys，完整且未过期/撤销。去掉 X-Api-Key:、Bearer 和空白，不用 OAuth、Cookie 或网页登录令牌。
- 403：insufficient_api_key_scope？
- 在同账户 Key 权限中确认 account:read 已保存。只读权限不包含写入，不需要为排错增加模型或管理员权限；无法配置时联系 HeyGen 支持或手动查看。
- 提示不支持账务类型或币种？
- 当前仅接受 billing_type=wallet 与 currency=usd。Enterprise currency=credits、subscription 和 usage_based 不会冒充美元余额；请手动查看，不必切换套餐或关闭保护。
- null、缺失或 invalid_response？
- null 代表尚无可用金额，不能当零。本站保留旧快照，不回退旧版 quota。记录脱敏错误与时间，核对官方钱包状态并稍后再试，不发送完整账户响应。
- 404、429 或查询超时？
- 404 可能是端点可用性变化，429 应等待限流结束，超时稍后重试。仅使用官方固定端点，不尝试镜像、Cookie 或扩大权限；注意页面显示的是旧成功时间还是新结果。
- 金额重复或与网页 Credits 不同？
- 相同上游账户可能被多个项目引用，不应汇总。API 美元钱包与网页订阅、企业 Credits、自动充值阈值及后付费消费上限不同；按同一账户和时间比较。
HeyGen 官方资料
- 官方 v3 账户查询与金额结构（在新标签页打开）
- 官方钱包、订阅与后付费区别（在新标签页打开）
- 官方 API Key 创建与认证（在新标签页打开）
- 官方最小读取权限（在新标签页打开）
- 官方 Key 权限自查字段（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。