教程更新
2026-09-28 用户反馈腾讯云中国站真实账号测试通过。尚未独立记录具体金额、所用 CAM 策略或 MCP 对账；首次接入仍请核对自己的账户、权限和金额。
- 所需凭据
- SecretId + SecretKey
- 监控币种
- CNY · 人民币（中国站，分换算为元）
- 可以看到什么
- 云账户真实可用余额 · 不含信用额度
- 直接读取官方 RealBalance 并精确除以 100，从分换算为元，不自行重算。官方定义由现金、收益转入和赠送余额扣除冻结、欠费构成，并非纯现金；不使用兼容字段 Balance 或信用额度代替。CreditBalance、RealCreditBalance 和临时额度单独展示，不与主金额重复相加。
在 Quota Monitor 中接入 腾讯云 / 混元（中国站）
准备好正确的中国站账户和管理权限
点击下方入口，登录实际给混元充值、承担扣费的腾讯云中国站账户，确认费用中心使用人民币。集团代付或伙伴结算时，先让财务确认资金归属；不要使用国际站账户。
以下配置需要由能创建 CAM 用户、策略和密钥的管理员操作。CAM 就是腾讯云的「访问管理」；我们会在现有云账户下创建专用子用户，不需要再注册腾讯云账号，也不会生成一份新的余额。管理员只负责完成设置，不要把管理员自己的密钥交给本站。
完成后检查：您能查看目标账户的费用，并有管理员协助完成访问管理配置。没有管理权限时，请让管理员按下面的步骤操作，不要为监控子用户授予管理员权限。
先创建一份余额查询策略，直接复制 JSON
点击下方「打开 CAM 访问管理」，在左侧进入「策略」，依次点击「新建自定义策略 → 按策略语法创建 → 空白模板 → 下一步」。策略可以理解为一张权限清单：先建清单，再把它分配给子用户。
在编辑策略页面，将「策略名称」填为 QuotaMonitorBalanceReadOnly；描述可填「仅供 Quota Monitor 查询账户余额」。删除策略编辑器里的默认内容，点击下面的复制按钮，把完整 JSON 粘贴进去，然后点击「完成」。如果提示名称重复，先检查已有同名策略的内容；不要覆盖其他业务策略，可以给新策略换一个名称，并在后面的步骤使用该名称。
这段 JSON 无需补填账号 ID、地域或密钥。action 只允许 finance:DescribeAccountBalance，前缀是 finance，不是 API 域名里的 billing。resource 为 * 是这个账户级查询的要求，不是允许所有操作，也不能改成某个混元项目 ID。
完成后检查：返回策略列表，搜索 QuotaMonitorBalanceReadOnly，能找到类型为「自定义」的新策略；策略内容只有下面这一项余额查询动作。
腾讯云余额查询权限 JSON
{ "version": "2.0", "statement": [ { "effect": "allow", "action": [ "finance:DescribeAccountBalance" ], "resource": [ "*" ] } ] }复制的是完整 JSON，不含密钥或账号信息。
进入子用户的自定义创建流程
仍在 CAM，点击左侧「用户 → 用户列表 → 新建用户」，选择「自定义创建」。在用户类型中选择「可访问资源并接收消息」，点击「下一步」。不要选「仅用于接收消息」，那不是供 API 查询使用的用户。
不要使用「快速创建」：该模式可能默认勾选管理员权限。我们只需要查询余额，不需要 AdministratorAccess、财务全权限或任何模型调用权限。
完成后检查：您已进入自定义创建的「设置用户信息」页面。如果已有专门用于余额监控、没有其他业务权限的子用户，可以跳过创建步骤，直接按第 6 步检查并绑定策略；不要修改正在被其他业务使用的子用户。
填写用户名，只开启编程访问
在「用户名」填写 quota-monitor，或其他便于识别的独立用户名。这个名称仅用于您在腾讯云中识别监控用户，不是本站项目名，也不是需要提交给本站的凭据。
在访问方式中勾选「编程访问」，不要勾选「腾讯云控制台访问」。本站通过 API 查询，不需要这个子用户的控制台密码。其余联系信息按页面要求和实际情况填写，然后点击「下一步」。
完成后检查：进入权限设置页面，刚创建的用户仅开启编程访问。若页面要求身份验证，请由管理员正常完成，不要关闭安全验证来绕过这一步。
选择刚创建的策略，完成子用户创建
在「设置用户权限」页面选择「从策略列表中选取策略关联」。将策略类型筛选为「自定义」，搜索 QuotaMonitorBalanceReadOnly，勾选第 2 步创建的那一条策略。
不要勾选 AdministratorAccess、QCloudFinanceFullAccess，也不要加入有额外权限的用户组。点击「下一步」；标签按需填写，没有需求可以不填；到审核页面再次确认用户名、编程访问和唯一的余额查询策略，再点击「完成」。
完成后检查：页面提示用户创建成功，用户列表里能找到 quota-monitor。如果完成页已提供 SecretId / SecretKey 或「显示密钥」，立即按第 7 步的安全要求保存这同一组凭据，后面不必重复创建密钥。
确认策略确实授权给了这个子用户
创建策略不等于已授权。进入「用户 → 用户列表」，点击 quota-monitor 用户名，在详情页的「权限策略」中搜索 QuotaMonitorBalanceReadOnly。如果已显示这条策略，不需要再次绑定。
如果没有找到，返回「用户列表」，点击该用户所在行操作列的「授权」。选择「自定义」策略，搜索并勾选 QuotaMonitorBalanceReadOnly，点击「确定」。随后回到该用户的「权限策略」再次检查。
完成后检查：这位专用子用户的权限策略中能看到余额查询策略，没有附加管理员、支付、资源管理或模型调用权限。不要只在策略列表里确认名称存在；真正发起查询的是这个子用户。
获取同一组 SecretId 和 SecretKey
如果第 5 步已经保存好一组完整密钥，直接进入下一步。否则进入「用户 → 用户列表」，点击 quota-monitor 用户名，打开「API 密钥」页签，点击「新建密钥」，由管理员按提示完成安全验证。注意是在这个子用户的详情页操作，不是创建主账号密钥。
在新建密钥的弹窗中，分别复制 SecretId 和 SecretKey。两项必须来自同一组，建议保存到可信的密码管理器，再填入本站安全表单；不要放进聊天、工单、截图或教程链接。SecretKey 只在创建时显示，关闭前先确认已经妥善保存。
完成后检查：您已取得这个专用子用户的一组有效长期 SecretId / SecretKey。不要填混元模型 API Key，也不要使用还需要额外 Token 的 STS 临时凭据；本连接不支持这两种方式。
回到 Quota Monitor，在项目中保存连接
登录 Quota Monitor，选择要管理的项目；还没有项目时，先填写项目名称并创建。进入项目的「添加供应商」区域，保持「添加新连接」模式，将供应商选为「腾讯云 / 混元（中国站·人民币）」。
「连接名称（可选）」可以填「腾讯云账户余额」；将上一步取得的两项凭据分别粘贴到「SecretId」和「SecretKey」，不要填反。无需填写地域、Uin 或混元项目 ID，币种固定为人民币。
点击「保存并接入项目」。完成后检查：当前项目出现腾讯云连接卡片，开始等待或执行首次同步。两项凭据在服务端一起加密保存，列表只显示 SecretId 末四位，不会展示完整密钥。
查询最新余额，确认接入成功
等待首次同步，或在连接卡片点击「查询最新余额」。完成后检查：不再停留于「等待首次同步」，没有查询失败提示，成功查询时间更新，并出现人民币余额。若失败，请按下方对应问题排查，不要把失败当作余额为零。
在同一腾讯云账户的费用中心核对金额和查询时间。本站主金额对应 RealBalance，即真实可用余额；官方原始单位为分，本站除以 100 展示为元，并不是只显示现金。展开卡片「余额说明」，分别查看现金、收益转入、赠送、冻结、欠费和信用字段；不要把信用额度与主余额相加。
如果需要充值，点击卡片「前往平台」到腾讯云处理。本站只负责查询，不会代您充值或修改云资源。
Quota Monitor 读取的 腾讯云 / 混元（中国站） 数据范围
- 仅接入腾讯云中国站人民币账户，不包含腾讯云国际站。该接口不返回币种字段，本站按中国站人民币口径展示，并非自动识别币种；国际站的接口和字段含义需要独立接入。
- 云账户资金由多个产品、项目和密钥共享，不是混元或本站项目的独立钱包。资源包、免费 Token、代金券清单及 Coding Plan 剩余额度不在本次查询范围内；赠送账户余额与代金券清单也不等同。
- 页面显示最近一次成功查询的快照，不保证上游结算没有延迟。拥有信用额度时，真实可用余额低或为零不等于模型一定停服；请分别核对余额类型、账户结算关系和查询时间。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
腾讯云 / 混元（中国站） 常见问题与排查
- 打不开访问管理，或没有新建用户/策略的权限？
- 当前登录的身份可能没有 CAM 管理权限。请让该云账户的管理员按第 2–7 步为您配置专用子用户，再通过安全表单填写密钥。不要给用于查询余额的子用户添加管理员权限，也不用向本站提供管理员登录密码。
- 为什么在授权页面搜不到刚创建的策略？
- 先把策略类型筛选为「自定义」，输入第 2 步实际保存的完整名称。如果仍没有，回到 CAM「策略」确认创建成功，并确认当前登录的是同一云账户，再刷新授权页面。创建好后，仍要按第 6 步在目标子用户的「权限策略」中确认绑定。
- 粘贴 JSON 后提示格式错误，应该改哪里？
- 先清空编辑器中的原内容，再点击本页复制按钮并完整粘贴，不要额外带上 Markdown 围栏、注释或中文引号。version、statement 等字段的大小写保持原样；action 必须是 finance:DescribeAccountBalance，不是 billing:DescribeAccountBalance。不要用 finance:* 来解决错误。
- 只找得到 SecretId，SecretKey 已经看不到了怎么办？
- SecretKey 只在创建时展示，之后不能重新查看。先检查自己可信密码管理器中的保存记录；确实没有时，在该专用子用户「API 密钥」页新建一组，按第 7 步保存完整配对。不要直接删除或禁用其他业务正在使用的密钥；若已达密钥数量上限，先让管理员确认旧密钥的使用情况并安排轮换。
- 普通混元 API Key 为什么不能使用？子用户不能登录控制台正常吗？
- 本连接查询的是云账户资金，需要 CAM SecretId / SecretKey，不是用于调用模型的混元 API Key。第 4 步只开启编程访问，因此这个子用户不能登录腾讯云控制台是预期行为；配置和核对由管理员完成，无需额外开启控制台登录。
- 提示密钥无效或没有查询权限？
- 先在目标子用户「API 密钥」确认密钥未被禁用，重新核对 SecretId / SecretKey 来自同一组、复制完整且属于中国站账户。若是权限不足，按第 6 步确认该用户已关联策略，再核对 action 为 finance:DescribeAccountBalance、resource 为 *，让管理员检查是否有显式拒绝。不要通过主账号密钥或扩大为管理员权限来排错；仍失败时只反馈脱敏错误码和查询时间，不发送密钥。
- 金额为什么与现金或信用额度不同？
- RealBalance 包含赠送等资金并扣除冻结和欠费；它与 CreditBalance、RealCreditBalance 是不同口径。本站保留官方数值的十进制精度，只做分到元换算。请先对齐账户、金额字段和时间，不把不同额度合并。
- HTTP 200、时间错误或字段缺失怎么办？
- 腾讯云业务失败也可能返回 HTTP 200，本站会检查 Response.Error 并显示失败；缺失 RealBalance 不会改用 Balance、信用额度或零。持续的签名时间错误需要管理员检查服务器时钟，失败期间的旧快照仅供参考。
腾讯云 / 混元（中国站） 官方资料
- 官方 DescribeAccountBalance 接口（在新标签页打开）
- 官方计费 CAM 权限指引（在新标签页打开）
- 官方费用中心授权粒度（在新标签页打开）
- 官方新建子用户与创建模式（在新标签页打开）
- 官方自定义策略授权操作（在新标签页打开）
- 官方子账号密钥管理（在新标签页打开）
- 官方 API 返回结果与业务错误（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。