余额查询是什么#
配置了余额接口的服务商，会在 设置 → 模型与用量 → 服务商管理 列表上直接显示账户余额；聊天页 选择模型 面板可一键刷新全部支持余额查询的服务商，余额显示在服务商一栏。金额按币种展示，查询失败会显示失败状态。
配置入口：服务商详情页 → 账户余额 区。
方式一：选模板#
内置 DeepSeek、硅基流动、Kimi、StepFun、OpenRouter 五个官方模板，选中即填好余额地址、路径与解析规则，保存后查询验证即可。模板不匹配时再手动微调，通常只需要改地址和结果路径。
方式二：让智能体帮你配置#
点击余额区的 让智能体帮你配置，进入 AI 服务商管理专用会话。把接口文档或服务商后台页面的说明发给它，AI 会真实试调、按返回结果修正解析路径；配置写入前会弹出确认面板。
自定义接口#
- 余额 Base URL / 余额 API 路径：Base URL 留空时使用服务商主地址。
- GET / POST 覆盖：接口要求 POST 时切换方法，并填写 请求体模板（JSON）。
- 自定义请求头（JSON 对象，可选）：默认发送 Accept 与 Authorization: Bearer 头，同名会被你的值覆盖。
- 占位符：请求体与请求头支持
{{apiKey}}与{{baseUrl}}。 - 结果 JSON 路径 / 币种 JSON 路径：告诉应用余额数值与币种在响应里的位置。支持点路径、数组下标与 +/- 表达式，纯数字按常量参与运算（如
100 - usage.monthly.percent算剩余百分比）；中转站返回的额度需要换算时，在单个路径后加* 正数或/ 正数，如data.quota / 500000（OneAPI 系中转的 quota 通常 ÷500000 才是美元金额）。 - 专用余额 Key（可选）：余额接口与模型接口凭据不同的服务商可单独填写，配置后查询请求优先使用它。
请求预览（已脱敏）#
预览按当前配置实时组装实际请求，凭据以掩码显示。发送前核对一遍，能提前发现地址写错、方法不对这类问题。
最佳实践#
- 优先选模板；每改一处就点查询验证，不要攒一批改动再一起测。
- 请求成功但金额显示不对时，优先检查 结果 JSON 路径——多数情况是数值嵌套在别的字段里；数字大得离谱（如几千万）通常是中转站的原始额度，需要加
/ 500000这类换算系数。 - 中转站与官方的余额接口不同时，用 专用余额 Key 或单独的 Base URL，避免影响模型调用。
- 冷门接口解析不出来，直接丢给智能体：贴上文档，让它试调到显示正确为止。
隐私提示#
余额查询由应用直接向你配置的服务商发起，不经过 Cube Agent 服务器；让智能体配置时，接口地址与文档会发送给你选择的管理模型。