余额总览
按 provider 查看余额、credits、低余额状态和最近同步时间。
余额与用量监控
把模型平台余额、credits、近 24h token usage 和请求明细放进同一套自托管服务，服务 Web、macOS、iPhone 和 Agent 工作流。
平台余额阿里云百炼、DeepSeek、Kimi、豆包、硅基流动、OpenRouter 等余额或 credits。
请求用量provider、model、tokens、project、account、resource 与时间戳。
数据边界Codex / Claude Code 订阅额度属于 AI Quota，不进入余额汇总。
余额、用量、来源
从余额概览进入请求归因，定位成本变化的具体来源。
请求归因
按项目、模型、账号、资源定位 token 消耗来源。
隐私边界
只记录结构化字段，不保存 prompt、response 或业务正文。
按场景进入
同一套余额服务，在不同工作场景里呈现不同的信息密度。
Web 看全量
适合排查消耗来源。大屏保留表格、筛选器和图表密度，不把看板压缩成小缩略图。
- 余额、近 24h usage、项目排行同屏查看。
- 请求明细保持可读，定位具体模型、账号和资源。
- 只记录结构化字段，不保存 prompt 或 response。
Report-only 接入
AI Balance 接收请求结束后的用量事件，不改变业务请求路径。
服务端写入，前端只读
- Provider key 保留在服务端，不下发到设备端。
- 查询 token 和 ingest token 分离，适配 Web、Agent、iPhone 与 macOS。
- 支持按业务维度聚合：project、account、actor、resource。
POST /api/usage-events
{
"provider": "deepseek",
"model": "deepseek-chat",
"project": "class-teacher",
"tokens": 12003,
"resource": "answer_extract"
}数据来源
通过服务端调用官方或稳定的余额接口；币种、账务口径和刷新时间保留来源标识，避免误合并。
阿里云百炼
DeepSeek
Kimi / Moonshot
豆包
硅基流动
OpenRouter
Usage API
常见问题
关于 AI Balance 的数据来源、刷新频率和隐私边界。
AI Balance 支持哪些模型平台？
目前支持阿里云百炼、DeepSeek、火山引擎 / 豆包、Kimi (Moonshot)、硅基流动和 OpenRouter，由服务端调用各平台官方余额或 credits 接口，也可以按文档自行适配新平台。
余额多久刷新一次？
服务端默认每 60 秒轮询一次各平台余额，间隔可通过 BALANCE_POLL_INTERVAL_MS 调整（最小 60 秒），每条余额都保留最近同步时间。
token 用量能看到什么粒度？
请求级。每条 usage 事件记录 provider、model、tokens、project、account、resource 和时间戳，可以按项目、模型、账号或资源聚合，定位具体消耗来源。
会保存我的 prompt 和模型回复吗？
不会。AI Balance 只记录结构化用量字段，不保存 prompt、response 或业务正文；云厂商 key 也始终留在服务端，不下发到任何客户端。
不同币种的余额怎么汇总？
只有 CNY（或平台显式给出的人民币金额）计入人民币总额；OpenRouter 等 USD credits 按原币种单独显示，不做汇率折算后混入总额。
Codex / Claude Code 的订阅额度也在这里看吗？
不在。5 小时、每周订阅额度窗口属于另一条产品线 AI Quota，它不进入 AI Balance 的余额汇总，也不和 credits 混算。
接入 AI Balance
部署服务端，配置 provider 来源，再接入 Web、macOS、iPhone 或 Agent。