产品文档
定位与首发范围
平台用户、首发边界、可选能力与发布门槛
服务对象
| 对象 | 需要解决的问题 | 首发交付 |
|---|---|---|
| 零售开发者 | 用一个 Key 调模型，知道价格、余额和实际扣费 | 文本 API、Console、充值与使用记录 |
| 创作产品用户 | 在不同产品使用同一个身份和钱包 | 共享登录、产品权限与统一消费接口；完整产品迁移后续执行 |
| FDE 与企业专属账户 | 约定价格、查看使用额度与账单 | 一个专属账户绑定价格方案及有效期；服务费与模型额度分开 |
| 运营与财务员工 | 管用户、模型、价格、支付异常与费用核对 | Admin、细分权限与操作审计 |
| 产品开发者 | 安全地代用户执行任务，故障后恢复 | 身份查询、受限产品授权、操作查询及非模型记账接口 |
uumi 原有模型对接客户继续使用现有业务。首发企业使用专属账户，不增加组织、成员邀请、共享钱包或多人协作。
首发必需
- 注册、登录、找回密码、全局退出、会话管理，以及后台校验的客户/员工/产品权限。
- 三种文本协议入口：OpenAI、Claude、Gemini。只开放协议与计量验证通过的具体模型组合；流式能力必须单独验证。
- 唯一积分钱包、可追溯的价格快照、人民币充值订单、可靠入账与持久账务恢复。
- 复用new-api的充值、计费和支付配置能力，首期支持后台配置优惠周/月订阅；价格、额度、周期和渠道填值不作为编码前置条件。
- API Key 生命周期、模型限制、额度限制、过期与撤销；限制是调用权限，用户余额仍只有一个。
- Console 的模型/价格、Key、钱包/订单、全平台使用记录、账户与安全设置。
- Admin 的用户、价格与客户方案、模型销售目录、订单、积分调整、任务核对、角色与审计。
- 一个隔离测试产品的完整身份和消费闭环，包括非模型收费。正式产品业务数据留在产品工程。
视频通道必须在阶段 1 给出结论。视频首发开放取决于任务、计价、退款与恢复验收；未通过时禁用销售入口，并明确记录后续产品上线的阻断。Console 任务模块只展示已启用的任务类型，未启用时不展示可执行入口。
按配置或证据开放
图片/音频供应入口、OAuth/OIDC、2FA、Passkey、兑换码和 Playground 均须先审计、确认需求和验收。不能把上游存在接口等同于 OceanWay 已支持。周/月订阅配置功能纳入首期，套餐配置完整、人民币支付和统一记账验收后上架；赠送积分与其他营销功能保持原待定范围。
后续阶段
Studio 迁移、Drama/Commerce 合并、老零售客户余额及旧价保护迁移、官网内容管理分别在后续阶段推进。采购渠道、供应商凭据及采购价由网关管理；产品项目、素材、作品和业务任务由 oceanway-studio 管理。
首发指标与门槛
首发以可核对结果为门槛：每笔消费可追溯，重复回调不重复入账，并发预留不透支，注销后不能创建新付费操作，权限绕过被后端拒绝。响应时间、容量、身份撤销时限、待核对时限与数据保留期限均待验证后确定，见决策清单。未确定指标不能写成“已经满足”，发布前必须给出测试环境和量化结果。