阿里云百炼余额查询：RAM AccessKey 只读接入教程

在 Quota Monitor 中接入 阿里云 / 百炼（中国站）

1. 01

   确认百炼实际扣费的中国站账户

   登录阿里云中国站的费用与成本控制台，在「账户 → 资金账户」确认账户、可用额度和现金余额。若存在企业统一结算或伙伴代付，先确认要监控的资金归属，不要把本站业务项目当成百炼钱包。

   打开阿里云费用与成本控制台（在新标签页打开）
2. 02

   创建专用 RAM 子用户与余额查询策略

   由管理员进入 RAM，为 Quota Monitor 创建独立的程序访问子用户，无需控制台登录。然后进入「权限管理 → 权限策略 → 创建权限策略 → 脚本编辑」，复制下方完整 JSON，替换新策略编辑器中的默认内容。保存时可命名为 QuotaMonitorBalanceReadOnly；代码无需填写账号 ID、AccessKey 或其他占位符。

   这份策略只允许余额查询。bss:DescribeAcccount 按 QueryAccountBalance 官方授权表原样填写，Acccount 中有三个 c，不要自行改写。Resource 为 * 是该接口的资源要求，并不表示允许所有操作。

   官方预设 AliyunBSSReadOnlyAccess 可查询更广的费用与账单信息，不是此处的最小授权方案。不要添加支付、充值、模型调用、资源管理或管理其他用户密钥的权限。

   阿里云余额查询权限 JSON

   复制 JSON

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

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

   打开 RAM 访问控制（在新标签页打开）
3. 03

   把自定义策略授权给专用子用户

   创建策略不等于已授权。进入「身份管理 → 用户」，找到刚创建的专用子用户，打开「新增授权」。授权范围选择「整个云账号」，从「自定义策略」中选中刚创建的 QuotaMonitorBalanceReadOnly，确认授权。此余额接口不支持资源级授权，不要限定到某个资源组。

   仅复制策略不会修改您的阿里云权限；需要由管理员在 RAM 完成上述绑定。首次同步仍需验证真实查询权限与金额，若被拒绝，先检查授权对象和显式拒绝规则，不要改用管理员密钥。

   查看官方 RAM 用户授权步骤（在新标签页打开）
4. 04

   为子用户创建并保存配套 AccessKey

   由管理员在该 RAM 用户的「凭证管理 → AccessKey」创建密钥，妥善保存 AccessKey ID 和只在创建时显示的 AccessKey Secret。不要使用百炼模型 API Key、主账号或管理员的密钥，也不要发到聊天中。当前只支持长期 AK/SK，不支持需要额外 Security Token 的 STS 临时凭据。

   查看官方 AccessKey 创建说明（在新标签页打开）
5. 05

   在项目内添加阿里云连接

   打开 Quota Monitor 的目标项目，添加供应商连接并选择「阿里云 / 百炼（中国站）」。分别填写 AccessKey ID 和 AccessKey Secret，保存后等待首次同步。币种固定人民币，无需填写地域或百炼项目 ID；两项凭据会一起加密保存，列表仅显示 AK 末四位。

6. 06

   刷新并分别核对可用额度与现金

   点击「查询最新余额」，确认成功查询时间更新。主金额与同一账户的可用额度核对；展开余额说明查看现金、信控等明细。不要用现金或资源包余量替代可用额度，也不要将各项重新相加。

   查看官方资金账户说明（在新标签页打开）

Quota Monitor 读取的 阿里云 / 百炼（中国站） 数据范围

• 只接入阿里云中国站人民币账户，不代表 Alibaba Cloud 国际站；国际站和其他币种不能沿用该连接。也不包含百炼资源包、免费 Token 或 Coding Plan 剩余额度。
• 多个项目和模型 Key 可能共用云账户资金，不要重复汇总。企业多账号、统一结算或生态客户应先确认实际扣费账户；Quota 限额不是剩余现金。官方未返回的明细不会填成零。
• 本站只查询资金，不调用模型、不充值、不修改云资源或 RAM 权限。金额为最近一次官方查询的快照，仍受上游账务入账时间影响，也不能单独据此判断模型是否可调用。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

阿里云 / 百炼（中国站） 常见问题与排查

百炼模型 API Key 为什么不能用？

本接入查询阿里云财务账户，使用 RAM AccessKey 请求签名，不是模型接口的 Bearer Key。请准备同一中国站账户下有查询权限的 RAM 子用户 AK/SK。

提示凭据无效或没有权限？

确认 AK/SK 是同一组且未停用，检查 bss:DescribeAcccount 是否按接口授权表填写，以及是否存在显式拒绝或来源限制。不要通过授予管理员权限来排错；只反馈脱敏错误码和查询时间，不发送密钥。

可用额度和现金为什么不一致？

可用额度与现金是不同字段，可能受信用额度和未结清费用影响。本站采用接口返回值，不自行重算。资金账户、企业结算关系或查询时间不一致时，也可能与页面金额有差异。

国际站、币种或请求时间报错怎么办？

当前仅支持中国站 CNY 账户，不会把美元或日元标成人民币。请先确认站点与凭据；若出现持续时间校验错误，联系管理员检查服务器时钟。失败时保留旧快照作为历史参考，不覆盖成零。

阿里云 / 百炼（中国站） 官方资料

• 官方 QueryAccountBalance 接口与授权动作（在新标签页打开）
• 官方自定义策略脚本编辑说明（在新标签页打开）
• 官方 RAM 用户授权步骤（在新标签页打开）
• 官方 RAM AccessKey 创建说明（在新标签页打开）
• 官方资金账户与金额口径（在新标签页打开）
• 官方费用只读系统策略范围（在新标签页打开）
• 官方 V3 请求签名规范（在新标签页打开）

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