Cleer
申请接入

合作方用户级计费(user_ref)

合作方 SaaS 平台接入后,可用 user_ref 字段把每次操作归属到贵司平台的最终用户,据此做自己的用户级统计与计费:

  • 上传时(/uploads、/uploads/direct)与创建分析时(/analyses)均可携带 user_ref——贵司平台用户的唯一标识(如 uid),仅用于用量归属与统计;
  • 用量查询:GET /v1/usage 返回 by_user(用户 → 调用次数)与 by_algorithm(算法 → 调用次数),贵司按用户聚合即可生成自己的用量报表;
  • 计费口径:我们账单按调用次数 + 算力时长(compute_seconds)双维度结算,贵司可在其之上自定义面向最终用户的计费模型(按次/套餐/加成),明细数据完全够对账;
  • 溯源:每笔分析的任务记录含用户标识、算法、耗时、产物数;每次上传含文件名/大小/摘要/用户标识——用户质疑账单时可精确回放当时的操作。

iframe 嵌入方式(规划中)下用户自动登录我们工作台,external_user_id 贯穿映射账号建档与每次分析记录,用户定位能力与 API 方式等同。