火山引擎与火山方舟余额查询：AK/SK 只读接入教程

在 Quota Monitor 中接入 火山引擎 / 火山方舟

1. 01

   确认方舟实际扣费的云账户

   登录火山引擎中国站，在费用中心确认实际扣费账户和可用余额。若使用企业财务关系或集中结算，先确认应监控哪个资金账户；不要把本站业务项目当成云厂商的钱包。

   打开火山引擎费用中心（在新标签页打开）
2. 02

   创建专用 IAM 子用户并授予查询权限

   由有权限的管理员打开访问控制，创建供 Quota Monitor 使用的独立子用户。优先用自定义策略只允许 billing:QueryBalanceAcct，资源范围为 *；不要添加支付、充值、资源管理或模型调用权限。

   若采用官方预设 BillingCenterReadOnlyAccess，它覆盖整个费用中心查询与导出，范围比单个余额动作更大；它与只读账单策略 BillingCenterBillReadOnlyAccess 不同，后者不覆盖账户余额。具体授权请按官方权限文档操作，首次接入验证权限是否生效。

   打开火山引擎访问控制（在新标签页打开）
3. 03

   为该子用户创建 Access Key

   由管理员在该子用户的密钥页面创建并妥善保存配套的 Access Key ID（AK）和 Secret Access Key（SK），无需给监控子用户添加管理其他用户密钥的权限。不要使用方舟模型 API Key 或主账号密钥。当前接入使用长期 AK/SK，不支持需要额外 Security Token 的 STS 临时凭据。

   查看官方访问密钥管理说明（在新标签页打开）
4. 04

   在项目内添加火山引擎连接

   打开 Quota Monitor 中的目标项目，添加供应商连接并选择「火山引擎 / 火山方舟」。分别填写 AK 和 SK，保存后等待首次同步；币种固定人民币，无需填写云地域或方舟项目 ID。两项凭据都会加密保存，列表只显示 AK 的末四位。

5. 05

   刷新并核对可用余额

   点击「查询最新余额」，确认成功时间已更新。与同一火山引擎账户费用中心的可用余额核对；现金、信控、冻结和欠费可展开卡片详情查看。金额有差异时先检查账户、查询时间和余额类型，不用现金余额或资源包额度替代可用余额。

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

Quota Monitor 读取的 火山引擎 / 火山方舟 数据范围

• 仅接入火山引擎中国站；不代表 BytePlus 国际站，也不包含方舟资源包、免费 Token、Coding Plan 或 Agent Plan 剩余额度。
• 官方可用余额考虑现金、冻结、信控及欠费。多个项目可能共用同一云账户，不应重复汇总；不返回的明细显示为未返回，不填成零。
• 这里只查询资金，不调用模型、不充值、不修改云资源或 IAM 权限。快照是最近一次官方查询结果，不能消除上游账务入账延迟。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

火山引擎 / 火山方舟 常见问题与排查

方舟 API Key 为什么不能用？

余额属于云账户费用中心，认证方式是 AK/SK 请求签名，不是模型接口的 Bearer Key。请使用有余额查询权限的 IAM 子用户访问密钥。

提示凭据无效或无权限？

确认 AK 和 SK 来自同一组有效密钥，未被停用；再检查 IAM 子用户的 billing:QueryBalanceAcct 权限。只读账单策略不能代替账户余额授权，不要通过授予管理员权限来排错。

可用余额比现金余额多？

可用余额还会考虑信控、冻结和欠费。本站直接采用官方 AvailableBalance，不把信控当成已充值现金，不自行加总得出余额。

签名或时间错误、仍在显示旧金额？

先确认 AK/SK 配套且无复制错误；持续时间错误需要管理员检查服务器时钟。查询失败不会覆盖成零，旧快照只能作为历史参考。反馈错误码和查询时间即可，不要发送任何密钥。

火山引擎 / 火山方舟 官方资料

• 官方 QueryBalanceAcct 接口（在新标签页打开）
• 官方费用中心权限说明（在新标签页打开）
• 官方账户余额口径（在新标签页打开）
• 官方请求签名方法（在新标签页打开）

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