Alibaba Cloud 国际站可用额度与 RAM AK/SK 接入教程

不托管 Key 时人工查看

1. 登录国际站账务控制台，在 Account > Billing Account 确认实际付款账户与币种。
2. 分开查看可用额度、现金、信用和账单，确认共享云服务范围，不汇总多个 Key 或项目。
3. 比较同币种、同范围、相近时间的数据；遇到非 USD/CNY/JPY、未返回值或延迟结算时保持未知，不换算。

在 Quota Monitor 中接入 Alibaba Cloud 国际站 / Model Studio

1. 01

   确认国际站账务账户与币种

   打开国际站 Billing and Cost Management，进入 Account > Billing Account，确认付款账户就是业务实际使用的账户。该可用额度可能支付 Model Studio 和其他云服务，不是 AI 专用钱包。

   记下实际显示的结算币种；仅 USD、CNY、JPY 可接入。EUR、SGD、HKD 或其他币种请保留人工查看，不要为了监控修改币种。控制台逐步升级时可从旧版底部 New Console 进入；没有入口时不要猜测路径。

   打开国际站账务控制台（在新标签页打开）
2. 02

   由现有管理员创建专用 RAM 用户

   在国际站 RAM 控制台进入 Identities > Users > Create User，填写 Logon Name 与 Display Name（例如 QuotaMonitorBalance）。不要使用主账号 AccessKey。

   只需要 Permanent AccessKey 程序化访问；无需 Console Access 或管理员权限。按官方提示完成私下安全验证并确认确需长期 Key。若您没有此现有管理权限，请让现有管理员完成，不提升监控用户角色。

   打开国际站 RAM（在新标签页打开）
3. 03

   创建仅查询账务的自定义策略

   在 Permissions > Policies > Create Policy 中切换 JSON Editor，粘贴下面的 Version 1 策略并命名 QuotaMonitorBalanceRead。动作 bss:DescribeAcccount 中 c 连续出现三次，Resource 为 * 是此动作官方资源范围。

   不要改成管理员、FullAccess、写账务权限或新版 bss:DescribeBillingAccount。本接入只调用 2017 接口；策略中没有账号、Key、端点或真实秘密。

   国际站最小只读 RAM 策略

   复制 JSON

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "bss:DescribeAcccount"
         ],
         "Resource": "*"
       }
     ]
   }

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

4. 04

   把策略附加到正确 RAM 用户

   返回 Identities > Users，找到刚建的专用用户，在 Actions 选择 Attach Policy。Grant Permission 中确认 Principal 是该用户，Resource Scope 选 Account level / Entire Alibaba Cloud Account，再选择 Custom Policy 中的 QuotaMonitorBalanceRead 并确认。

   创建策略本身不会授权。核查附加后的有效权限只有所需查询动作；不要选资源组代替账户级范围，也不要为排错附加管理策略。此步骤由现有管理员一次性完成，监控本身不执行授权。

   官方：为 RAM 用户授权（在新标签页打开）
5. 05

   私下保存配对 AK/SK

   若创建用户时已生成长期 AccessKey，使用那一组，无需重复创建。对已有专用用户，打开用户详情 > Credential > AccessKey > Create AccessKey，按官方提示选择使用场景并完成安全确认。

   完整 AccessKey Secret 通常只在创建时展示；AK/SK 必须同一组。不要开启全局允许用户自行管理 AccessKey，也不要粘贴 STS SecurityToken、模型 Key 或完整 Authorization 请求头。最多两组的轮换约束以官方页面为准。

   官方：创建 AccessKey 对（在新标签页打开）
6. 06

   在项目中选择国际站与实际币种

   回到 Quota Monitor 目标业务项目，添加连接，选择 Alibaba Cloud 国际站 / Model Studio。在两个密码字段分别输入专用 RAM 的 AccessKey ID 与 AccessKey Secret，并明确选择与账务控制台一致的 USD、CNY 或 JPY。

   MCP 的安全凭据设置链接使用同一供应商；不要把 AK/SK 放进 AI 对话或工具参数。凭据加密保存，其他视图仅显示末四位。没有地域、任意 URL、项目或 Key 筛选；帮助抽屉只显示本教程，不读取或提交输入。

7. 07

   刷新并核对官方可用额度

   首次同步后确认成功查询时间更新，再对比同一付款账户、同币种的 Available Credit / AvailableAmount。原值例如 123.4567890123456789 USD 是美元主单位，不是分；0 和负值按原义保留。

   主卡片显示可用额度，不是现金。AvailableCashAmount、CreditAmount、MybankCreditAmount、QuotaLimit 分别核对；缺失或 null 表示未返回，不能以零代替或相加。接口没有模型余量、重置时间和最终费用，providerAvailable 保持未知。

   打开账务账户核对（在新标签页打开）
8. 08

   理解共享范围和版本限制

   多个业务项目或 Key 显示相同金额可能是共用账务账户，不能加总。不要拿模型调用用量、资源包、预算、信用上限或国内站余额与此可用额度混为一谈。

   官方另有 2023 GetFundAccountAvailableAmount，账务类型和多币种字段不同。本接入有意固定已文档化的 2017 端点和单一权限，不自动回退或扩权；若币种不匹配或版本不适用则失败保留旧快照。

9. 09

   安全排错与轮换

   401/403 时检查是否选国际站、AK/SK 配对与撤销状态、策略是否真正附加及 bss:DescribeAcccount 拼写。AuthSiteFail、SignatureDoesNotMatch、InvalidTimeStamp 或 SignatureNonceUsed 时检查站点与服务时钟；429 稍后重试。不要靠调用收费模型验证。

   仅通过安全表单轮换专用监控 Key，成功后再停用旧监控 Key，不动业务凭据。查询失败不会把旧金额变成零或刷新成功时间；只提供脱敏错误代码，不提交 Cookie、不充值、不升级或扩大权限。

Quota Monitor 读取的 Alibaba Cloud 国际站 / Model Studio 数据范围

• 2017 接口文档仅列 USD、CNY、JPY；必须选择实际账务币种并与返回值完全一致。国际站可有 EUR、SGD、HKD 等其他结算币种，本接入不支持，不猜测、不换算，不要求更改结算币种。
• 国内站 aliyun 与国际站 aliyun_global 使用独立凭据、固定端点和验证状态。不会从新加坡端点重试到国内站，也不会自动切换到 2023 API 或扩大权限。
• 可用额度可能包含信控、退款额度及待结算影响，并非可提现现金。现金、CreditAmount、MybankCreditAmount 和 QuotaLimit 不可直接相加重算；未返回值为未知而非零。
• 多个云服务、Key 和 Quota Monitor 项目可能共享同一账务账户，不能汇总重复连接。账务账户也可能支付其他账户；以您实际关联的付款范围为准。
• 原始数值是原币主单位，不是分；保留十进制字符串与正负号。不会推断重置、到期、模型可用性或最终账单；自填日耗推算的剩余天数只是估算。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Alibaba Cloud 国际站 / Model Studio 常见问题与排查

这是 Model Studio 余额还是纯现金？

都不是。AvailableAmount 是共享国际站云账务账户可用额度，可能含信用。现金和信用分别返回，不自动分配给 Model Studio、项目或 Key。

为什么必须选币种，EUR、SGD、HKD 能用吗？

2017 接口文档仅列 USD、CNY、JPY。本接入要求显式选择且返回一致；其他币种安全拒绝，不猜 USD、不换算、不要求修改结算币种。

策略已创建但仍是 403？

创建不等于附加。检查专用 RAM 用户的 Attach Policy、账户级范围、实际生效的自定义策略及 bss:DescribeAcccount（连续三个 c）。不添加管理员或 FullAccess 权限。

模型 Key、国内 AK 或 STS 为什么不行？

Model Studio API Key 不等于 RAM AK/SK。国内与国际站分别管理；本接入不支持 STS 临时凭据、任意端点或地区路由，不能靠修改 URL 绕过。

金额不一致或现金为负？

先确认付款账户、币种与查询时间，再分别核对 AvailableAmount 和现金/信用字段。不能重算、加总或从信用额度推断现金；可用额度不证明所有模型都可调用。

超时、429 或字段缺失怎么办？

稍后重试并检查官方服务状态；响应币种不符、金额缺失/格式错误或失败信封都会保留旧快照和成功时间。不要输出 AK/SK、签名、原始响应或身份字段，仅分享脱敏错误代码。

Alibaba Cloud 国际站 / Model Studio 官方资料

• 国际站 QueryAccountBalance 2017-12-14 与最小权限（在新标签页打开）
• 国际站账务端点（在新标签页打开）
• 账务账户、可用额度与结算币种（在新标签页打开）
• 创建 RAM 用户（在新标签页打开）
• 创建自定义策略（在新标签页打开）
• 为 RAM 用户附加策略（在新标签页打开）
• 创建 AccessKey 对与风险（在新标签页打开）
• ACS3 V3 请求与签名（在新标签页打开）
• 新版账务 API 的独立模型（本接入不调用）（在新标签页打开）
• Model Studio 模型 Key 与站点（在新标签页打开）

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