计费与用量
wesgine 引擎层的 Token 用量记录与计费集成机制。
Token 用量记录
引擎自动记录每次 LLM 调用的 Token 消耗：
| 维度 | 说明 |
|---|---|
cell_id | 所属 Cell |
provider | Provider 名称 |
model | 使用的模型 |
input_tokens | 输入 Token 数 |
output_tokens | 输出 Token 数 |
actor | 请求发起者 |
session_id | 所属会话 |
agent_id | Agent 标识 |
查询 API
细粒度查询
GET /cells/{id}/observe/token-usage
参数：
GroupBy：model / agent / session / day / tag:actorTags：按标签过滤Model：按模型过滤From/To：时间范围
聚合摘要
GET /cells/{id}/observe/token-summary
返回总体摘要统计。
按维度聚合
GET /cells/{id}/observe/token-usage/aggregate
参数：agent / group_by=day / days=N
计费不变量（INV-BILLING）
| ID | 规则 |
|---|---|
| INV-BILLING-01 | 平台 wes: 模型访问权 = UserStatus + LLM Proxy |
| INV-BILLING-02 | Token refresh 检查 UserStatus，欠费仍签发身份 JWT |
| INV-BILLING-03 | LLM Proxy 转发前检查 UserStatus，fail-closed |
| INV-BILLING-04 | BillingRequired provider 过期后 fallback 到 BYOK |
| INV-BILLING-05 | 应用层不做 billing pre-check 或 post-run settle |
三层计费架构
| 层 | 职责 |
|---|---|
| wesgine | 记录 raw token (cell_id, provider, model, in/out) |
| 应用层 | 本地 Observe 记 token；不做应用层 settle |
| weisyn 平台 | 费率表 + 代理结算 + 钱包扣费 |
Provider 来源与计费
| 来源 | 计费方式 |
|---|---|
wes: 平台代理 | 代理 SettleProxy 写入用户钱包 |
org: 企业托管 | 扣组织账户 |
| BYOK 自有密钥 | 直接调用，平台不计费 |