# 服务商余额查询怎么配置？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/provider_balance/

## 余额查询是什么

配置了余额接口的服务商，会在 **设置 → 模型与用量 → 服务商管理** 列表上直接显示账户余额；聊天页 **选择模型** 面板可一键刷新全部支持余额查询的服务商，余额显示在服务商一栏。金额按币种展示，查询失败会显示失败状态。

配置入口：服务商详情页 → **账户余额** 区。

## 方式一：选模板

内置 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 服务器；让智能体配置时，接口地址与文档会发送给你选择的管理模型。