教程更新
2026-10-17 已按官方国际站 API、账户币种与 CAM 文档实现。真实国际账号、最小权限、登录后步骤及金额对账待用户测试;中国站成功记录不移用。没有代登录、修改权限或调用收费模型。
- 所需凭据
- 国际站专用 CAM 子用户 SecretId / SecretKey
- 监控币种
- USD · 官方国际站交易币种;美分除以 100,不换汇
- 可以看到什么
- 可用信用额度(CreditBalance)· 非现金
- 固定只读 POST https://billing.intl.tencentcloudapi.com/,DescribeAccountBalance 2018-07-09,TC3-HMAC-SHA256,TempCredit=true。主金额取 CreditBalance / 100,属于凭据所属国际云账户,包含非 AI 服务;不是混元、业务项目或单 Key 钱包。不查询账单、不充值、不改权限,不请求模型。
不提供密钥时手动查看
- 自行登录国际站,由具备财务权限的人员进入 Billing Center → Payment Management → Payment。
- 确认当前账户和 USD,分别看可用信用额度、信用总额、冻结与欠费;不要把付款渠道币种或现金当 CreditBalance。
- 记下核对时间;金额可能随结算变化。如页面字段与 API 含义不对应,请先咨询腾讯云,不重算现金。
在 Quota Monitor 中接入 Tencent Cloud 国际站
1. 确认国际站和账务账户
由账户负责人自行登录 console.tencentcloud.com,进入 Billing Center(费用中心)→ Payment Management → Payment。确认这是实际付费的国际云账户,交易币种为 USD;中国站请改选独立的腾讯云中国站教程。
完成检查:先能由有财务权限的人员查看同一账户的可用额度。不要为监控充值、开通授信或改变自动付款;没有账户管理权限时请既有管理员协助。
2. 创建专用 CAM 子用户
管理员打开 CAM → Users → User List → Create User → Custom Creation,选择 Access Resources and Receive Messages。填写独立名称,例如 quotamonitor-billing-intl;不要选默认带 AdministratorAccess 的 Quick Creation。
完成检查:只为 API 访问开启 Programming access,不需要控制台密码登录;不要选仅接收消息的用户。按页面完成验证和用户创建,不绑定管理员或宽泛财务模板,不改动已有业务用户。
3. 新建单动作权限策略
在 CAM → Policies → Create Custom Policy → Create by Policy Syntax 中选择 Blank Template,点击 Next,给策略命名,例如 QuotaMonitorIntlBalanceRead。清空模板正文,粘贴下面完整 JSON 后点击 Complete。
完成检查:version 为 2.0,唯一 action 为 finance:DescribeAccountBalance,resource 为 *。API 服务名是 billing,但 CAM 权限前缀是 finance;操作级接口不能缩小为某个项目资源,也不支持该动作的 IP 条件。不要复制官方其他示例中的管理员模板。
CAM 2.0 · 仅查询账户额度
{ "version": "2.0", "statement": [ { "effect": "allow", "action": [ "finance:DescribeAccountBalance" ], "resource": [ "*" ] } ] }复制的是完整 JSON,不含密钥或账号信息。
4. 把策略实际授权给子用户
返回 CAM → Users → User List,找到刚创建的专用用户,点击 Authorization(授权)。在策略列表筛选自定义策略,选中 QuotaMonitorIntlBalanceRead 并点击 OK;也可从用户详情的 Permissions → Associate Policy 关联。
完成检查:在该用户权限列表中看到已关联策略,核对动作仍只有 finance:DescribeAccountBalance。仅保存策略不等于授权。重名时核对内容或使用新的专用名称,不覆盖其他业务策略。
5. 保存同一组 SecretId 和 SecretKey
在该子用户详情打开 API Keys → Create Key。将新建弹窗中的 SecretId 和 SecretKey 一起保存在安全密码管理器中;如果创建用户时已生成此专用密钥,可直接使用,不必再创建。
完成检查:两项来自同一国际站子用户、同一组有效密钥。SecretKey 仅在创建时提供,丢失时由管理员按已有安全流程换新,不删除其他业务密钥或扩大授权。不要将其发到聊天、截图、浏览器 URL 或 MCP 参数。
6. 在 Quota Monitor 选择国际站
回到 Quota Monitor,打开目标工作区和项目,添加供应商连接,选择「Tencent Cloud 国际站 · USD」。填写易识别的连接名,例如腾讯国际账务;不要选择中国站。
完成检查:表单要求 SecretId 和 SecretKey 两个密码字段,不要求 Region、Uin、端点、项目 ID 或模型 API Key。USD 固定,不能用 CNY 或付款银行卡的本币替换。
7. 填写并保存连接
将 SecretId 填入同名字段,SecretKey 填入 SecretKey 字段,按本站表单保存;通过安全设置链接录入时先确认链接属于您自己的工作区。连接凭据加密保存,之后不会回显完整值。
完成检查:连接列表出现国际站名称,只显示密钥后缀。查看帮助抽屉不会提交表单;切换供应商会清空未保存凭据。日常不需要再提供云账户密码或主账号 Key。
8. 刷新并逐字段完成首次对账
等待首次同步,或点击「查询最新余额」,检查成功同步时间是否更新。主卡片「可用信用额度(CreditBalance)」按美分除以 100 显示 USD;合成示例 12345.67890123456789 美分应为 USD 123.4567890123456789。
完成检查:由财务负责人在同一国际账户核对可用信用额度,而非现金、信用总额或月账单。卡片详情保留 RealBalance、RealCreditBalance 等原字段含义;若控制台文案不同,先确认其对应 API 字段,不用其他字段凑成主金额。REST/MCP 的 tencentGlobalBalance.availableCredit 与卡片一致。
9. 持续监控并保留验收边界
下次刷新失败时先看错误码、最近成功时间和下方排错,不把旧金额当成新查询。零值、负值、冻结或临时额度可能有不同业务含义,遇到疑问向腾讯云核对,不自动推断停服或重置日期。
完成检查:记录您自己的真实最小权限和首次金额对账结果后再确认验收。本文是基于公开官方文档的操作指引,不代表我们已登录您的控制台走通流程;不充值、不改自动付款或授信。
Quota Monitor 读取的 Tencent Cloud 国际站 数据范围
- 国际站 USD 与中国站 CNY 独立;端点、凭据、含义和实测状态不共用,不自动回退国内端点。API 不返回币种,USD 依据官方国际账户定义,而不是根据语言或地区猜测。
- CreditBalance 是可用信用额度。RealBalance、RealCreditBalance、CreditAmount、FreezeAmount、OweAmount、TempCredit 各自展示,不能互相替代或相加,也不以信用总额减余额推算费用。
- 官方示例的 RealBalance=0,而 CreditBalance 与 RealCreditBalance=10000000000 美分;相似描述不保证字段相等。CashAccountBalance、IncomeIntoAccountBalance、PresentAccountBalance 在国际站标为未应用,本站不将其零值当现金。
- 保留零、负数与小数美分;缺少主字段或无权限时同步失败并保留旧值/时间。没有重置或到期承诺,不把临时额度明细日期当重置时间,不据余额判断模型是否可用。
- 同一云账户在多个项目重复接入仍是同一份额度,不可累加。本站阈值与日耗尽估算是您自己的监控设置,不会改变腾讯云信用额度、账期或扣费安排;本接口不提供实际日耗。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商,但不保证上游账务没有入账延迟;失败时旧余额不能当成新结果。
Tencent Cloud 国际站 常见问题与排查
- 提示 UnauthorizedOperation.CamNoAuth 或权限不足?
- 检查专用用户是否真正绑定了 version 2.0 的 finance:DescribeAccountBalance 策略,resource 是否为 *,以及组织权限边界/显式拒绝。不要使用 billing: 前缀或添加管理员权限来排错。
- 提示 AuthFailure、签名或时间错误?
- 核对同一组 SecretId/SecretKey 的完整值、有效状态与国际站来源;模型 Key、国内凭据和 STS 不适用。SignatureExpire 需要检查服务器时间,不要把签名或密钥发到聊天。
- 可用信用额度与现金、RealBalance 不一致?
- 这是不同字段。官方国际示例本来就可能不相等;主值仅取 CreditBalance,其他字段单独显示。国际 CashAccountBalance 等字段未应用,不据它们推断现金。
- 银行卡以 KRW 扣款,为什么卡片是 USD?
- 国际站官方交易/账务币种为 USD;韩国支付渠道可能以 KRW 扣款。本站只把美分除以 100,不做换汇,不跟随银行卡币种。
- 额度为空、为负、同步失败或 429?
- 空/缺少 CreditBalance 不等于零;格式或权限错误保留旧快照。负数按原值展示,不强行归零;429 可等待下一轮。持续失败保留脱敏错误码和时间核查,不提交完整上游响应。
- 何时重置,能否单独显示混元项目余额?
- 此接口只读共享云账户额度,没有本接入可承诺的重置时间、项目钱包或 Key 限额。临时额度日期不作为重置时间;不累加重复连接,也不据此保证模型可调用。
Tencent Cloud 国际站 官方资料
- 国际站 DescribeAccountBalance(在新标签页打开)
- 官方账户与 USD/CNY 站点区分(在新标签页打开)
- CAM 财务权限粒度(在新标签页打开)
- 官方财务 CAM 权限前缀(在新标签页打开)
- 创建子用户(在新标签页打开)
- 创建自定义策略(在新标签页打开)
- 授权与策略关联(在新标签页打开)
- 子账号密钥管理(在新标签页打开)
- 国际站 USD 与付款渠道币种(在新标签页打开)
- Payment 入口与额度类型(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。