成本变量
不同模型可能按输入 token、输出 token、媒体单位、批处理或缓存折扣计费。星模XModel 在模型页和价格页展示当前已发布的计费口径。Chat 流量先按输入 token、输出 token 和请求量估算,再用账户账单事件做真实核对。
| 输入成本 | 输入 token × 输入单价 / 1,000,000 |
| 输出成本 | 输出 token × 输出单价 / 1,000,000 |
| 月估算 | 单次预估 × 月请求 |
生产流量用账号控制
网关会检查账户余额、支付限制、Key 策略和限流规则。不同提供方的模型都落在同一套账户和账单控制里。
| 余额 | 在产生提供方成本前拦截不可用请求 |
| 限流 | 用策略保护账号不被突发流量打穿 |
| 流水 | 核对成功调用、拒绝调用和充值记录 |
| 价格页 | 上线前比较模型成本和默认选择 |
在代码里查询余额与用量
每个有效 API Key 都能程序化读取自己的钱包和消费。模型价格始终以 GET /v1/models 里各模型的 pricing 字段为准;余额与消费走三个只读端点(Bearer 鉴权),金额单位为人民币(钱包币种)。legacy dashboard 两个端点遵循 one-api 生态检查器惯例:limit 字段是累计充值额度,total_usage 按 1/100 单位缩放(即 ×100),于是 剩余 = hard_limit − total_usage/100 正好等于余额;total_usage_cny 给出真实的元数值。
| GET /v1/balance | 钱包快照:可用、预留、累计充值/消费;计费面响应同时带 x-remaining-balance 头 |
| GET /v1/key | 当前 Key 信息:仪表盘名称、该 Key 累计消费、余额;limit 为 null(暂无按 Key 限额) |
| GET /v1/dashboard/billing/subscription | one-api/OpenAI legacy 额度,供余额检查器使用;currency=CNY 并附 balance_cny |
| GET /v1/dashboard/billing/usage | start_date/end_date 区间消费(YYYY-MM-DD,东八区日界,end 含当日);total_usage(×100)+ total_usage_cny |