用量与计费

City 计量每次模型调用并追踪所有已连接 Agent 和产品的用量。这是计费、配额和成本管理的基础。

用量追踪

• 每次模型请求都会被计量（输入 token、输出 token）
• 用量按用户、按项目和按模型聚合
• 控制台中提供实时用量仪表板

持有有效 Admin Session 的 Federation 管理员可以读取服务端聚合结果：

GET /v1/usage/admin/overview?from=2026-07-07&to=2026-08-05&timezone=Asia/Shanghai
GET /v1/usage/admin/users?from=2026-07-07&to=2026-08-05&timezone=Asia/Shanghai
GET /v1/usage/admin/retention?from=2026-07-07&to=2026-08-05&timezone=Asia/Shanghai

overview 返回范围活跃、真实去重的 DAU/WAU/MAU 日序列、调用结果、Token 构成、 Credits、模型与 Action 分布、当地小时分布，以及平均/P50/P95 执行耗时。users 按用户 返回调用次数、Input/Output/Total Token、成功率、Top Model、Credits、耗时与最后活跃时间。 retention 使用 Accounts 注册时间和真实 AI Usage 活跃日计算 D1、D3、D7、D14、D30 注册 Cohort 留存。活跃用户定义为统计窗口内至少产生一次 AI Usage Record 的用户；失败和 取消调用仍表达真实产品使用，因此计入活跃，并单独进入结果与成功率。

余额

• 用户在 City 中维护余额账户
• 余额随着用量产生而消耗
• 余额低时触发提醒
• 可以配置自动充值

计费

City 与 Stripe 集成，支持：

• 一次性支付
• 订阅计划
• 基于用量的计费
• 发票生成

配额

• 软配额在达到限制前发出警告
• 硬配额在超出时阻止请求
• 配额可以按用户、按项目或按模型配置

继续阅读：

• 模型池
• City 身份