LLAiGateway 首页

Token 与计费说明

区分输入、缓存与输出 Token,理解分组报价、动态规则和实际结算。

自动选择模型(auto)

管理员开启后,可以把模型写成 auto(显示为「自动」):网关按这次要做的事,从你有权限的分组里挑一个合适的模型并定思考强度。计划、架构、疑难 bug 想得深;按计划改代码时更快更省;闲聊用轻量模型。

计费、日志和成本都按实际使用的模型计算。响应头 X-LLAi-Auto-Model / X-LLAi-Auto-Effort / X-LLAi-Auto-Reason 写明实际模型、思考强度和原因,使用记录里也能看到「请求的模型 = 自动」和实际模型。

同一个任务(请求头 X-LLAi-Session)会一直沿用第一次选出的模型,缓存不会失效;卡住时客户端发 X-LLAi-Auto-Stuck: 1,或连续两次失败,才升一档。可用 X-LLAi-Auto-Preference 选「省钱 economy / 均衡 balanced / 最强 max」,用 X-LLAi-Session-Budget 设单个任务的预算上限:接近上限时自动降一档,到上限就停下。

规则拿不准时,网关会调用一次便宜的小模型判断难度;这次判断按站点设置计入你的账单(单独一条「自动路由判断」)或由平台承担。

Token 统计口径

输入 Token 已包含缓存读取与写入;总 Token=输入+输出,缓存不重复叠加。缓存命中率是已细分记录的缓存读取 Token 占已细分输入 Token 的比例,不是请求次数命中率。

历史细分未知、估算记录或数据异常会明确提示。控制台统计来自仍保留的小时汇总,不包含尚未写入的在途请求,也不代表账号全部历史。

公开报价

模型默认价格是本站配置的计费基准,不代表厂商官方价格。分组价格=该分组有效基础价格×计费倍率,分组可独立覆盖价格和规则。

Token 价格按每百万 Token 展示,单次请求价格按次展示。本站货币名称仅改变显示单位,1 个显示单位=1,000,000 微单位,不自动进行 USD 或其他法币汇率换算。

动态规则

上下文档位、请求条件和时段规则可能调整费用。上下文档位按匹配下限选择,不是累进计价;上下文独立单价优先于时段单价,上下文倍率作用于匹配的时段基础价。

时段独立价格不再重复叠加该时段倍率。分组选择影响页面报价,不改变 API Key 的路由、权限或已经发生的结算。

预占与结算

调用前可能预占额度,完成后按记录用量与锁定规则结算;失败会按现有资金恢复机制处理。预占金额不是最终扣费。

严格模式按输入估计、请求允许的输出上限和计价规则预占。管理员可逐模型开启钱包低预占:纯个人钱包支付改用较小的输出资金预算,实际输出上限不变,超出预占的真实费用仍会扣款,可能形成负余额。套餐、赠额、仅套餐 Key 和团队保持严格预占,Key 金额额度及 Token 限流仍按完整请求检查。并发预占会减少可用额度,因此即使有总余额也可能返回 402。未指定输出上限时仍沿用原默认收缩规则。

本地故障的计费策略、上游消费不确定说明和 HTTP 状态都不能单独证明余额已扣除。核对最终实际金额、账务状态和资金来源。

余额查询接口

GET /v1/usage 使用与模型请求相同的 API Key(Authorization: Bearer 或 x-api-key)查询该 Key 当前可花的金额,单位为人民币元。它不计费、不写请求记录、不访问上游,每个 Key 每分钟最多 30 次,超出返回 429。

remaining 取 Key 金额额度剩余与资金剩余中较小者:个人 Key 的资金为钱包可用余额加未过期赠额;团队 Key 为所有者钱包、团队月度/累计预算和成员月度/累计预算中最紧的一项。有效套餐余额单独放在 subscription_remaining,只能用于套餐覆盖的模型;仅套餐 Key 的 remaining 即为套餐余额。设置了金额额度的 Key 另返回 used 和 total。plan_name 为有效套餐名,否则为 Key 的主分组名。已吊销或已过期的 Key 返回 401。

兼容旧客户端:GET /v1/dashboard/billing/subscription 的 hard_limit_usd 为该 Key 已用加剩余(单位仍为元),GET /v1/dashboard/billing/usage 的 total_usage 为该 Key 累计已用金额乘以 100;日期参数会被忽略。控制台「导入 CC Switch」生成的链接已附带余额查询脚本,导入后卡片每 5 分钟显示一次余额(CC Switch 要求 HTTPS 端点)。

curl 'https://www.llaigw.com/v1/usage' -H "Authorization: Bearer $GATEWAY_API_KEY"
# {"object":"usage","is_valid":true,"remaining":12.5,"unit":"CNY","currency_symbol":"¥","plan_name":"default","expires_at":null}

全部接入文档