-
Notifications
You must be signed in to change notification settings - Fork 1
Providers
每家平台调什么接口、展示什么、有什么已知限制。仅做只读查询,不代管账号。
| 数据源 | 接口 | 展示内容 |
|---|---|---|
| DeepSeek | GET /user/balance |
总余额、充值余额、赠金余额(CNY/USD)、可用状态 |
| 火山方舟 Agent Plan |
GetPersonalPlan + GetAFPUsage + GetUsageDetails + GetCodingPlanUsage + GetInferenceUsage
|
卡片上是 Agent Plan 的 5 小时/每周/每月配额与进度、重置倒计时;模型日额度(只对图片/视频/语音与 Harness 生效)、套餐档位与有效期、Coding Plan 状态与窗口额度、模型调用明细、近 N 天推理用量(可按模型过滤)全部收进「详情」弹窗 |
| 智谱 GLM |
GET /api/monitor/usage/quota/limit(Coding Plan)+ 控制台 biz API(余额/资源包) |
Coding Plan 套餐等级与 5 小时/每周窗口额度、账户余额、Token 资源包明细 |
| 阿里云百炼 |
QueryResourcePackageInstances(BSS) |
Token 资源包实例:总量/剩余、有效期、状态、适用产品(需 BSS 只读权限) |
| 阿里云百炼 Token Plan | ModelStudio OpenAPI(ROA):GetSubscriptionSeatDetails / ListSubscriptionSharedPackages;个人版用量经控制台网关(zeldaHttp.apikeyMgr./tokenplan/personal/api/v2/*,Cookie 或 AK/SK 均可) |
TokenPlan 账户/组织信息、订阅座席与共享包的 CREDITS 额度周期、总额/剩余;个人版 5 小时/7 天窗口用量、订阅状态与剩余天数、加购包 Credits、重置卡 |
| 模力方舟(Gitee AI) |
GET /tokens/packages/balance + 内部接口(Cookie) |
资源包总金额/已用/剩余、代金券余额与明细(需配置会话 Cookie) |
| 百度智能云千帆 | 平台功能 OpenAPI(/v2/charge + /v2/service,BCE AK/SK 签名) | 量包(总量/已用/到期/状态)+ TPM 配额 + 近 7 天调用概览(Token/次数/服务数) |
| OpenRouter |
GET /api/v1/credits + GET /api/v1/key
|
剩余额度 / 限额剩余 / 今日用量(「余额账户」Tab);充值总额、周月用量、密钥元数据在「详情」弹窗内 |
| New API(自托管网关) | 管理接口 /api/user/self + /api/log/self/stat + /api/data/self(系统访问令牌);无管理权限时回落 OpenAI 兼容 /v1/dashboard/billing/*(普通 API Key) |
订阅(周期额度窗口:已用百分比、周期额度、下次重置时间)归「套餐订阅」;钱包(剩余 / 累计已用 / 请求数)归「余额账户」;两者并存时订阅为主、钱包作次要读数 |
| 订阅套餐(可选) | Kimi For Coding(/coding/v1/usages)/ MiniMax(coding_plan/remains)/ OpenCode Go(/zen/go/v1/usage),统一走 /api/usage 的 plans 切片 |
按窗口计的订阅额度,与火山/智谱/百炼并列在「套餐订阅」Tab;一平台一张卡,卡片标题即平台名,卡显示窗口进度条,账号身份与窗口明细在「详情」弹窗内 |
这是本项目里最容易被误读的一段,单独说明。
Agent Plan 的额度分两套互不相干的限额:
- 5 小时 / 每周 / 每月 —— 文本与向量化模型受它管;
- 模型日额度 + 月额度 —— 只对图片 / 视频 / 语音模型与 Harness 生效。
因此「只跑文本时,日额度 Used 恒为 0」是预期行为,不是接口读错了。
据此的展示策略:
| 位置 | 放什么 |
|---|---|
| 卡面 | 只留 5 小时 / 每周 / 每月三个窗口 |
| 详情弹窗 | 模型日额度走 cardFace: false,只进弹窗 |
| 概览「最近重置」 | 排除日额度 —— 它不是同一套限额,混进去会误导「最快重置」的读法 |
参考:Agent Plan 套餐额度口径 https://www.volcengine.com/docs/82379/2366394
用量接口在 200 响应中为每个窗口附带 status(ok / rate-limited)。
当某窗口被上游限流时,接口报 percent: 100 且 status: "rate-limited"。
两者语义不同:一个是「额度用完了」,一个是「被上游限流了」。因此面板会把该状态单独标为 「上游限流中」并附说明,而不是只显示 100%。
New API 是自托管网关,同一套服务端可能同时开启两种计费模式:
- 钱包余额 —— 充值的额度,只减不重置;
- 订阅额度 —— 按周期窗口重置,常见 30 天。
服务端用管理接口返回的配额字段与订阅状态共同判定该账号属于哪一类,并据此归到正确的 Tab,
不需要你手工声明。两种都开启时(mode: 'both')以订阅为主读数、钱包作次要读数,
弹窗里给出站点的扣费偏好(subscription_first / wallet_first)。
取值与货币单位详见 凭据与多账号 → New API。
ALIYUN_ACCESS_KEY_ID / ALIYUN_SECRET_KEY 与 ALIYUN_TOKENPLAN_COOKIE 互不替代,
两者并存时相同序号视为同一账号、只出一张卡。
对照表与权限要求见 凭据与多账号 → 阿里云。
Key(账号)多的平台排前面(3 Key > 2 Key > 1 Key),数量相同时按平台名首字母 A→Z。 首字母对中文取拼音、对拉丁名取字母,混在同一个序列里 (阿里→A、百度→B、DeepSeek→D、模力→M、OpenRouter→O、智谱→Z), 而不是把英文平台一律丢到汉字后面。
「套餐订阅」「余额账户」两个 Tab 与总览的「平台导航」卡片用同一套顺序, 导航卡点哪家就落在页面对应位置。
每张平台卡的标题旁都有「可用模型 ↗」,新标签打开该平台官方的模型/计费文档。
链接按**卡片标题(平台名)**在 src/modelDocs.ts 统一查表:同一平台在不同 Tab 标题不同
(如「智谱 GLM Coding Plan」与「智谱 GLM 余额」)也只需一条关键词映射,新增平台卡补一行即自动生效。
总览「平台导航」卡上同样有该链接;点链接只开文档,不会顺带触发卡片本身的锚点跳转。
- DeepSeek 查询余额:https://api-docs.deepseek.com/zh-cn/api/get-user-balance/
- 火山方舟 Base URL 及鉴权:https://console.volcengine.com/ark/region:cn-beijing/docs/82379/1298459?lang=zh
- GetPersonalPlan:https://console.volcengine.com/ark/region:cn-beijing/docs/ark/get-personal-plan-api?lang=zh
- GetAFPUsage:https://console.volcengine.com/ark/region:cn-beijing/docs/82379/2479847?lang=zh
- GetUsageDetails:https://console.volcengine.com/ark/region:cn-beijing/docs/82379/2479849?lang=zh
- GetInferenceUsage:https://console.volcengine.com/ark/region:cn-beijing/docs/82379/2116766?lang=zh
- Agent Plan 套餐额度口径:https://www.volcengine.com/docs/82379/2366394
- 火山引擎签名方法:https://www.volcengine.com/docs/6369/67269
- 百炼 CLI(官方,Token Plan 用量实现来源):https://github.com/modelstudioai/cli
- 百炼控制台 Token Plan 个人版页面(Cookie 通道的请求来源):https://bailian.console.aliyun.com/cn-beijing/subscription/token-plan/personal
- 百炼 CLI 用量与配额文档:https://docs.bailian.console.aliyun.com/zh/model-studio/cli/usage-quota
- 百炼 Token Plan 系列 OpenAPI(当前网关未开放,实测 404):https://docs.bailian.console.aliyun.com/zh/model-studio/get-subscription-stats
- New API 管理接口鉴权:https://docs.newapi.ai/zh/docs/api/management/auth
- New API 用量统计(按模型):https://docs.newapi.ai/zh/docs/api/management/statistics/data-self-get
- New API 日志统计:https://docs.newapi.ai/zh/docs/api/management/logs/log-self-stat-get
- New API 源码(订阅 / 钱包字段定义来源):https://github.com/QuantumNous/new-api
- OpenCode Go 用量参考实现(cc-switch PR #6547):https://github.com/farion1231/cc-switch/pull/6547
- OpenCode Go 用量端点与字段语义(
GET /zen/go/v1/usage,窗口status/percent/resetsAt):https://github.com/looplj/axonhub/pull/2204
更深入的供应商调研(响应样本、字段推导、失败模式)在仓库
docs/ 目录下:
aliyun-token-plan-research.mdgitee-voucher-research.mdcc-switch-usage-query-research.md