术语表
文档中常用术语的含义
| 术语 | 含义 |
|---|---|
| 平台 | oceanway-platform，持有账号、权限、钱包和模型 API 的统一服务 |
| 产品 | Site、Studio、Drama、Commerce 等面向用户的业务应用。Console 和 Admin 是平台的前端，不算独立产品仓库 |
| 产品工程 | oceanway-studio 仓库里的 Next.js 应用，承载 Studio、Drama、Commerce 三个子站 |
| 子站 | 产品工程里按子域名区分的一个产品，例如 Drama 子站 |
| 网关 / 上游 | 平台背后负责真正调用模型供应商的服务：uumi（文本）和媒体网关（视频） |
| uumi | 基于 new-api 的文本模型网关，代码仓库为 oceanway-text-gateway；服务模型对接客户，同时是平台的文本上游 |
| new-api | 开源的模型 API 网关项目，平台以它的最新版本为起点 |
| 积分 | 平台内的余额单位。用户用人民币充值换成积分，调用和产品功能消耗积分 |
| 价格方案 | 一个账户适用的价格规则，例如零售标准、老零售客户、FDE、企业协议价 |
| 分组倍率 | new-api 中按用户分组调整价格的机制，用来实现不同客户的差异价 |
| 预扣 / 结算 / 释放 | 扣费的三个动作：调用前按估算先冻结积分，完成后按实际用量扣除，失败或多冻结的部分退回 |
| 幂等 | 同一个请求重复提交多次，效果和只提交一次相同，不会重复扣费 |
| 使用记录 | 每一次扣费的明细，包括来源产品、模型、用量、价格和扣除的积分 |
| 来源产品 | 使用记录上标注的产品，例如 API、Studio、Drama、Commerce，用于在 Console 按产品筛选 |
| 产品服务凭据 | 产品后端代表用户调用平台时使用的凭据，形式待定，见身份与权限 |
| 平台角色 / 产品角色 | 平台角色控制平台级权限（如员工、财务）；产品角色控制某个产品内的权限（如 studio:admin） |
| 共享 Cookie 登录 | 平台把会话 Cookie 写在主域名下，所有子域名上的产品都能识别同一个登录用户 |
| FDE | 购买定制专属套餐的企业客户，在平台上使用专属账户和协议价 |
| 模型对接客户 | 在 uumi 上购买模型供应能力的企业客户，不迁入平台 |
| 归档 | 2026-10-01 之前的旧代码和旧文档，只读保留，不作为现行依据 |