教程更新
2026-10-01 用户反馈百度智能云中国站接入测试完成，可正常获得余额。尚未独立记录具体金额、所用子用户权限策略、限定资金范围或 MCP 对账；首次接入仍请核对自己的账户、权限和现金余额。本教程操作路径依据官方文档，未登录云控制台逐项实操。
- 所需凭据
- Access Key ID（AK）+ Secret Access Key（SK）
- 监控币种
- CNY · 人民币（仅中国站）
- 可以看到什么
- 云账户现金余额
- 直接读取官方 cashBalance，不估算、不叠加信用额度。余额属于整个百度智能云账户，不是千帆、单个 API Key 或本站项目的独立钱包。现金余额可能有线上资金与定制账单限定资金之分，接口未提供细分，需在财务中心核对适用范围。
在 Quota Monitor 中接入 百度智能云 / 千帆（中国站）
确认中国站账户与现金余额
登录实际承担千帆扣费的百度智能云中国站账户，打开「财务 → 账务总览 → 账户总览」，确认现金余额以人民币元显示。存在企业组织、代付或定制账单时，先请财务确认查询的是哪一个账户。
完成后检查：知道应核对的账户、人民币现金金额与资金使用范围。不是人民币或不是中国站时，先不要添加此连接。
由管理员进入子用户管理
请能管理 IAM 用户及授权的管理员操作，监控用户本身不需要管理权限。在控制台右上角头像下找到「多用户访问控制 → 用户管理 → 子用户」，选择「创建子用户」。IAM 是云账户内的权限管理，不需要再注册一个百度账号。
完成后检查：已打开目标云账户下的子用户创建页面；管理员只负责设置，不会把自己的密钥交给本站。
创建专用用户，只开启编程访问
用户名可填 quota-monitor，备注按需填写。访问方式只选择「编程访问」，不需要「控制台密码访问」。不要勾选快速授权中的系统管理员权限，也不要让监控用户加入具有其他权限的用户组。完成创建。
完成后检查：用户列表中能找到新用户，编程访问已开启，没有系统管理员或云资源管理权限。已有独立监控子用户可直接检查其权限，不要修改正在被其他业务使用的用户。
保存创建时提供的同一组 AK/SK
开启编程访问会生成 AccessKey。创建页面若提供密钥，立即通过复制或下载安全保存同一组 Access Key ID 与 Secret Access Key。Secret Key 自 2025-05-15 起只在创建时明文提供，后续不能从列表重新查看。不要把密钥粘贴到聊天、工单、公共文档或截图中。
完成后检查：已安全保存一组完整且配套的 AK/SK。若未保存或创建页未提供，按第 7 步由管理员在该子用户下创建新组；不要复制主账号的密钥。
绑定财务中心只读系统策略
返回「用户管理 → 子用户」，打开 quota-monitor 的详情，在「权限信息」中添加权限。搜索系统策略 FCReadAccessPolicy，核对中文名称为「财务中心只读权限」，仅选择这项并完成授权。无需新建 JSON 策略、填写地域、项目 ID 或资源路径。
该策略还能查看和下载账单、查看发票合同、订单及代金券，不是仅查余额；它不允许支付或取消订单。不要选择 FCFullControlPolicy、FCOrderAccessPolicy 或系统管理员权限。本站只调用余额查询，不会调用其他财务接口。
完成后检查：该子用户的权限信息中出现 FCReadAccessPolicy。只在策略列表找到它不等于已给用户授权。余额接口文档没有细化此策略的授权映射，首次同步仍需验证；不要用全权限密钥绕过失败。
检查用户的完整有效权限
再检查直接授权及用户组权限，确认没有附加管理员、支付、资源管理等权限。若存在显式拒绝、企业组织限制或来源限制，请管理员核对是否允许这项只读财务查询；不要擅自放宽其他业务规则。
完成后检查：专用用户仅具有您接受托管的财务只读权限。若连只读账单权限也不愿托管，请暂不添加，本版本没有经过确认的仅余额单动作方案。
若 SK 没有保存，由管理员补建密钥
已经安全保存配套密钥可跳过。否则请管理员回到该专用子用户详情的「AccessKey」管理中创建新密钥，完成安全验证后立即复制或下载 AK/SK。不要为监控子用户增加 IAM 管理或管理员权限，只让管理员代为创建。不要停用其他业务正在使用的旧密钥。
完成后检查：手里的 AK/SK 属于这个已授权子用户，密钥仍启用。当前只支持长期凭据，不支持需要额外安全令牌的 STS 临时凭据。
在目标项目添加百度云连接
进入 Quota Monitor 的目标项目，选择「添加新连接」，供应商选择「百度智能云 / 千帆（中国站·人民币）」。填写便于识别的连接名，在两个掩码框分别粘贴 AK 和 SK，再点击「保存并接入项目」。无需填地域、端点、千帆项目 ID 或模型 API Key。
完成后检查：项目中出现百度云卡片，等待首次同步。凭据会一起加密保存，列表仅显示 AK 末四位，不会再次返回明文。
刷新并核对官方现金余额
点击卡片的「查询最新余额」，等待查询完成，确认成功查询时间更新。在同一百度云账户的财务中心对照「现金余额」，不要与信用额度、可用额度、资源包或千帆项目预算比。余额说明中可查看共享账户范围，平台跳转按钮可打开财务中心，由您手动充值。
完成后检查：币种、账户、现金余额和查询时间一致。出现差异时检查限定资金、代付关系与结算时间；查询失败会保留旧快照，不能把历史金额当作本次结果，本站不会代为充值。
Quota Monitor 读取的 百度智能云 / 千帆（中国站） 数据范围
- 接口不返回币种字段，本站仅按中国站人民币账户展示，不自动识别币种；其他站点或非人民币结算账户不能用这个连接。
- 不包含信用额度、代金券、资源包、免费 Token 或 Coding Plan 余量，也不是可提现金额。现金余额低不等于千帆必然停服，有余额也不保证所有模型可用。
- 展示最近一次成功查询的官方快照，可能受上游结算延迟、限定资金和企业代付关系影响。不同项目共用同一云账户资金时，不应重复相加。
- 官方已公开财务只读系统策略，但未在余额文档中明确单动作自定义策略。本教程使用系统策略，不提供未经证实的权限 JSON，也不声称真实子用户授权已通过。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
百度智能云 / 千帆（中国站） 常见问题与排查
- 千帆 API Key 为什么不能用？
- 财务接口采用云账户 AK/SK 的 BCE 签名认证，不是模型 API 的 Bearer Key。请使用同一中国站账户中专用子用户的配套 AccessKey，而非应用 API Key、OAuth Token 或主账号密钥。
- 为什么不给一段只查余额的权限 JSON？
- 官方公开了 FCReadAccessPolicy 系统策略，未在余额接口中确认可用的单动作自定义策略。这里直接选择系统策略，不编造 JSON；该策略范围比余额读取宽，首次真实子用户查询仍需验证。
- 没有权限或搜不到 FCReadAccessPolicy 怎么办？
- 请管理员确认是在目标云账户的系统策略中搜索，策略确实绑定到拥有这组 AK 的子用户，且没有显式拒绝或组织限制。若仍失败，向百度云提供脱敏错误码和时间确认授权，不要改用管理员密钥，也不要发送 SK。
- Secret Key 已经看不到或凭据被拒绝？
- SK 仅创建时提供明文。请管理员在专用子用户中创建新密钥并保存同组 AK/SK，再在本站安全录入页更新；不要关闭生产业务的旧密钥。检查复制空格、密钥是否停用，持续时间错误由本站管理员检查服务器时钟。
- 现金余额与千帆可用额度不同？
- 此接口只返回 cashBalance，不返回信用、代金券、资源包或定制账单资金细分。请按同账户、同时间的现金口径核对，不自行相加，也不能从现金数值推断模型一定可用或不可用。
百度智能云 / 千帆（中国站） 官方资料
- 官方账户余额查询 API（在新标签页打开）
- 官方财务只读权限范围（在新标签页打开）
- 官方财务 API 子用户访问控制（在新标签页打开）
- 官方子用户创建、授权与密钥管理（在新标签页打开）
- 官方 AK/SK 获取及只显示一次规则（在新标签页打开）
- 官方现金余额与资金使用范围（在新标签页打开）
- 官方 BCE v1 签名规范（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。