计费与余额

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

计价规则

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

余额与充值

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

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

用量查询

控制台提供三个粒度：

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

API 查询用量

第三方客户端（如 CC Switch 的用量面板）只有 API Key、进不了控制台，可以用数据面的用量概览接口：

curl https://soleapi.com/v1/usage \
  -H "Authorization: Bearer $SOLEAPI_API_KEY"

# => { "remaining": 131.4, "used": 69.6, "total": 201, "unit": "Credits" }

remaining 是可用余额（含奖励余额），used 是累计消费，total 是两者之和；单位为 Credits（1 Credit 对应模型目录里 1 美元标价的记账点数）。金额以 JSON 数字原样输出、不经浮点转换。接口免费，但计入 RPM 限流，不要高频轮询。

成本控制建议

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