Tencent Cloud 国际站可用信用额度与 CAM 密钥接入教程

配置 Tencent Cloud 国际站最小 CAM 权限,读取 USD 共享云账户可用信用额度,区分现金、授信总额和国内站,并完成首次对账。

待真实账号验证

教程更新

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 钱包。不查询账单、不充值、不改权限,不请求模型。

不提供密钥时手动查看

  1. 自行登录国际站,由具备财务权限的人员进入 Billing Center → Payment Management → Payment。
  2. 确认当前账户和 USD,分别看可用信用额度、信用总额、冻结与欠费;不要把付款渠道币种或现金当 CreditBalance。
  3. 记下核对时间;金额可能随结算变化。如页面字段与 API 含义不对应,请先咨询腾讯云,不重算现金。
打开国际站费用中心(在新标签页打开)

在 Quota Monitor 中接入 Tencent Cloud 国际站

  1. 1. 确认国际站和账务账户

    由账户负责人自行登录 console.tencentcloud.com,进入 Billing Center(费用中心)→ Payment Management → Payment。确认这是实际付费的国际云账户,交易币种为 USD;中国站请改选独立的腾讯云中国站教程。

    完成检查:先能由有财务权限的人员查看同一账户的可用额度。不要为监控充值、开通授信或改变自动付款;没有账户管理权限时请既有管理员协助。

  2. 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. 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. 4. 把策略实际授权给子用户

    返回 CAM → Users → User List,找到刚创建的专用用户,点击 Authorization(授权)。在策略列表筛选自定义策略,选中 QuotaMonitorIntlBalanceRead 并点击 OK;也可从用户详情的 Permissions → Associate Policy 关联。

    完成检查:在该用户权限列表中看到已关联策略,核对动作仍只有 finance:DescribeAccountBalance。仅保存策略不等于授权。重名时核对内容或使用新的专用名称,不覆盖其他业务策略。

  5. 5. 保存同一组 SecretId 和 SecretKey

    在该子用户详情打开 API Keys → Create Key。将新建弹窗中的 SecretId 和 SecretKey 一起保存在安全密码管理器中;如果创建用户时已生成此专用密钥,可直接使用,不必再创建。

    完成检查:两项来自同一国际站子用户、同一组有效密钥。SecretKey 仅在创建时提供,丢失时由管理员按已有安全流程换新,不删除其他业务密钥或扩大授权。不要将其发到聊天、截图、浏览器 URL 或 MCP 参数。

  6. 6. 在 Quota Monitor 选择国际站

    回到 Quota Monitor,打开目标工作区和项目,添加供应商连接,选择「Tencent Cloud 国际站 · USD」。填写易识别的连接名,例如腾讯国际账务;不要选择中国站。

    完成检查:表单要求 SecretId 和 SecretKey 两个密码字段,不要求 Region、Uin、端点、项目 ID 或模型 API Key。USD 固定,不能用 CNY 或付款银行卡的本币替换。

  7. 7. 填写并保存连接

    将 SecretId 填入同名字段,SecretKey 填入 SecretKey 字段,按本站表单保存;通过安全设置链接录入时先确认链接属于您自己的工作区。连接凭据加密保存,之后不会回显完整值。

    完成检查:连接列表出现国际站名称,只显示密钥后缀。查看帮助抽屉不会提交表单;切换供应商会清空未保存凭据。日常不需要再提供云账户密码或主账号 Key。

  8. 8. 刷新并逐字段完成首次对账

    等待首次同步,或点击「查询最新余额」,检查成功同步时间是否更新。主卡片「可用信用额度(CreditBalance)」按美分除以 100 显示 USD;合成示例 12345.67890123456789 美分应为 USD 123.4567890123456789。

    完成检查:由财务负责人在同一国际账户核对可用信用额度,而非现金、信用总额或月账单。卡片详情保留 RealBalance、RealCreditBalance 等原字段含义;若控制台文案不同,先确认其对应 API 字段,不用其他字段凑成主金额。REST/MCP 的 tencentGlobalBalance.availableCredit 与卡片一致。

  9. 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 国际站 官方资料

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

自动监控 Tencent Cloud 国际站

手动登录控制台查看很容易忘。Quota Monitor 会通过官方接口替你读取 Tencent Cloud 国际站 的数据。

  • 默认每 10 分钟刷新一次,也可以随时手动刷新。
  • 余额不足、Key 失效或同步失败会排在总览最上方。
  • 按项目查看各平台账号,也可以通过远程 MCP 在 Claude 等 AI 助手里直接询问余额。
免费开始使用

使用另一个站点?查看 腾讯云 / 混元(中国站) 接入教程