跳到主要内容

计费系统概览

GeniSpace 采用基于 Token 的计费模式，为用户提供灵活、透明的付费服务。我们的计费系统支持个人账户和团队协作，确保每一次服务使用都有详细的记录和统计。

核心概念​

Token 计费模式​

  • Token 单位：所有 AI 服务（Agent、Operator、Assistant）均以 Token 为计费单位
  • 实时扣除：每次使用服务时实时从账户余额中扣除相应 Token
  • 透明计费：详细记录每次使用的服务类型、Token 消耗和使用者信息

计费账户类型​

个人计费账户​

  • 自动创建：每个用户注册激活时自动创建个人计费账户
  • 新用户福利：新用户注册可获得免费 Token，具体数量请查看官网活动
  • 存储功能：存储 Token 余额和使用历史
  • 支持充值：支持充值和消费记录追踪

团队计费机制​

  • 基于所有者：团队计费直接基于团队所有者的个人计费账户
  • 统一管理：个人团队和协作团队使用相同的计费逻辑
  • 责任明确：团队所有者承担团队的所有计费责任
  • 简化架构：通过团队所有者直接关联计费账户

订阅计划​

免费计划 (FREE)​

  • 基础功能：完整的个人团队功能体验
  • 个人使用：仅支持个人团队，无法创建协作团队
  • 完整计费：拥有完整的计费统计和分析功能
  • 新用户福利：新用户注册可获得免费 Token

企业版 (ENTERPRISE)​

  • 协作功能：创建协作团队权限（最多4个协作团队）
  • 团队管理：完整的团队成员和权限管理
  • 高级统计：完整的计费统计和分析功能
  • 多时区支持：基于团队所有者时区的精确统计

计费流程​

1. 账户创建​

用户注册账户
    ↓
邮箱验证激活
    ↓
自动创建个人计费账户
    ↓
自动赠送免费 Token
    ↓
创建个人团队（设置为团队所有者）
    ↓
获得基础使用权限

2. 团队使用​

团队成员执行任务
    ↓
获取团队所有者的计费账户
    ↓
检查账户 Token 余额
    ↓
扣除所需 Token
    ↓
记录详细使用日志（标记团队和用户）
    ↓
更新实时统计数据

3. 统计生成​

API 请求统计数据
    ↓
验证用户团队权限
    ↓
获取团队所有者时区
    ↓
计算时区调整后的日期范围
    ↓
自动生成缺失的历史统计
    ↓
实时计算当前统计
    ↓
计算环比增长率
    ↓
返回完整统计数据

服务类型​

Agent 服务​

  • 智能体对话和任务执行
  • 按输入/输出 Token 分别计费
  • 支持多种 AI 模型

Operator 服务​

  • 工具（算子）调用
  • 按总 Token 消耗计费
  • 支持自定义工具

Assistant 服务​

  • 助手智能体会话
  • 多轮对话 Token 累计
  • 支持复杂交互场景

统计与分析​

实时统计​

  • 当日使用量：实时计算今日 Token 消耗
  • 当月使用量：累计本月 Token 使用情况
  • 服务分布：各服务类型的使用占比

环比分析​

  • 日环比：今日相比昨日的增长率
  • 月环比：本月相比上月的增长率
  • 智能处理：自动处理零值情况

多时区支持​

  • 基于团队所有者时区：统计数据按团队创建者时区计算
  • 精确时区处理：支持夏令时和历史时区变更
  • 全球用户友好：确保统计数据的准确性

使用记录​

详细日志​

每次服务使用都会记录：

  • 使用者信息
  • 团队信息
  • 服务类型和参数
  • Token 消耗详情
  • 执行时间和状态
  • 输入输出内容

交易记录​

所有 Token 变动都有完整记录：

  • 消费记录（CONSUME）：服务使用时的 Token 扣除
  • 充值记录（RECHARGE）：用户主动充值 Token
  • 奖励记录（BONUS）：系统赠送 Token（如新用户注册奖励）
  • 退款记录（REFUND）：服务异常时的 Token 退还
  • 调整记录（ADJUSTMENT）：管理员手动调整 Token

数据安全​

隐私保护​

  • 使用记录仅团队成员可见
  • 计费信息严格权限控制
  • 敏感数据加密存储

数据完整性​

  • 事务性操作确保数据一致性
  • 自动备份和恢复机制
  • 详细的审计日志

API 接口​

核心接口​

  • GET /billing/stats?teamId=:teamId - 获取团队计费统计（自动触发统计生成）
  • GET /billing/account - 获取用户个人计费账户信息
  • GET /billing/teams/:teamId - 获取团队计费信息
  • GET /billing/teams/:teamId/history - 获取团队历史统计数据
  • PUT /billing/teams/:teamId/owner - 转移团队所有权
  • POST /billing/deduct - 手动扣除Token（用于测试）

响应格式​

{
  "success": true,
  "data": {
    "teamId": "uuid",
    "teamName": "团队名称",
    "billingAccountId": "uuid",
    "accountOwner": "账户所有者",
    "tokenBalance": 9880,
    "totalTokensUsed": 120,
    "lastUsageAt": "2025-06-15T10:30:00Z",
    "needsSubscription": false,
    "dailyUsage": 120,
    "dailyGrowthRate": 100,
    "monthlyUsage": 120,
    "monthlyGrowthRate": 100,
    "serviceUsage": {
      "agent": { "tokens": 60, "calls": 3 },
      "operator": { "tokens": 25, "calls": 1 },
      "unified": { "tokens": 35, "calls": 1 }
    },
    "recentTransactions": [...],
    "usageRanking": [...],
    "detailedStats": {
      "today": {...},
      "yesterday": {...},
      "thisMonth": {...},
      "lastMonth": {...}
    }
  }
}

最佳实践​

成本控制​

  1. 定期监控：关注 Token 使用趋势和余额变化
  2. 合理规划：根据团队规模和使用频率制定预算
  3. 优化使用：选择合适的 AI 模型和参数
  4. 及时充值：Token 不足时及时充值避免服务中断

团队管理​

  1. 明确责任：团队所有者承担团队的所有计费责任
  2. 透明沟通：向团队成员说明计费机制和使用规范
  3. 定期回顾：分析使用情况和成本效益
  4. 所有权管理：必要时可以转移团队所有权

数据分析​

  1. 利用统计：通过环比分析优化使用模式
  2. 服务分布：了解各服务类型的使用情况
  3. 用户排行：识别高频使用者和使用模式

故障排除​

常见问题​

  • Token 余额不足：及时充值或优化使用策略
  • 统计数据延迟：系统会自动生成缺失的历史统计数据
  • 时区显示异常：检查团队所有者的时区设置
  • 计费账户未创建：新用户需要完成邮箱验证激活
  • 团队计费异常：确认团队所有者有有效的计费账户

技术支持​

如遇到计费相关问题，请联系技术支持团队，我们会及时为您解决。

最后更新：2025年6月