成本变量

不同模型可能按输入 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/subscriptionone-api/OpenAI legacy 额度,供余额检查器使用;currency=CNY 并附 balance_cny
GET /v1/dashboard/billing/usagestart_date/end_date 区间消费(YYYY-MM-DD,东八区日界,end 含当日);total_usage(×100)+ total_usage_cny