计费与余额

SoleAPI 按 token 用量计费，余额以 USD 计。没有月费与最低消费，用多少扣多少。

计价规则

• 每个模型有独立的输入/输出单价，按「美元 / 百万 token」标示；部分模型还区分缓存读/写 token 与推理（reasoning）token，各按对应单价计算。
• token 数以上游返回的 usage 为准；流式请求在流结束后按结束事件里的用量结算。
• 各模型的标价见官网模型页；控制台里能看到适用于你账号的实际单价（平台折扣与倍率自动生效，不需要在请求里做任何配置）。
• count_tokens 之类的计数接口不产生模型调用费用。

余额与充值

在控制台钱包页充值（支持 Stripe 在线支付与兑换码）。每一笔余额变动——充值、消费、奖励、调整——都有对应流水可查，余额与流水金额同刻度记账，对得上账。

余额不足时请求返回 402（balance_exhausted）。计费是后付费的（费用要等上游返回 token 数才能确定），余额可能出现小幅负值，下次充值时自动抵扣；详见速率限制与配额。

用量查询

控制台提供三个粒度：

• 仪表盘：当前余额、消费趋势、请求量与成功率概览。
• 用量统计：按 API Key、按模型聚合的消费与 token 统计。
• 明细日志：逐请求记录，可按模型、Key、时间范围筛选，用于对账与排查。

成本控制建议

• 给每把 Key 设消费额度，按天/周/月自动重置，把预算前置到 Key 层。
• 用 max_output_tokens / max_tokens 限制单次输出上限，防止长输出放大成本。
• 发送前用计数接口预估长文本的输入 token，超预算的请求提前截断。
• 开启余额预警，低余额时收到通知而不是收到 402。