上游接口清单与产品映射
首批已核验端点与需要扩展的能力
本页的 new-api 路由是固定源码参考，不代表 OceanWay 已部署该接口。现行实现责任按 Core、API Edge、Contracts 分仓；已有契约默认沿用 new-api，新增/变更部分单独定义并验证。
来源：固定版本 API 路由和同提交的 relay / task 路由。下表为源码存在，尚未证明新工作区已能运行这些端点。
| 产品动作 | 已有路径／机制 | 身份或限制 |
|---|---|---|
| 浏览公开价格 | GET /api/pricing | 可受公开模块配置影响，需运行核对 |
| 登录、刷新、退出 | /api/user/login、/api/user/auth/refresh、/api/user/auth/logout | 按上游会话和 Origin 规则 |
| 查看本人账号 | GET /api/user/self | UserAuth |
| 查看／撤销会话 | GET /api/user/sessions、DELETE /api/user/sessions/:sid | 本人身份 |
| 管理 Key | /api/token/ 的 GET／POST／PUT；DELETE /api/token/:id | UserAuth；读取密钥另有受限端点 |
| 查看订阅 | GET /api/subscription/plans、GET /api/subscription/self | 客户身份 |
| 查看充值记录 | GET /api/user/topup/self | 客户身份；支付创建按具体提供方 |
| 本人调用与统计 | GET /api/log/self、GET /api/log/self/stat | 本人范围 |
| Key 用量 | GET /api/usage/token/ | 只读 Token 鉴权 |
| 模型列表 | GET /v1/models | API Token；与匿名模型展示区分 |
| 文本与 Responses | 相应 /v1 Relay 路由 | Token、模型范围与费用策略 |
| 通用异步任务 | POST /v1/tasks/:key、GET /v1/tasks/:key | Token；提交时 key 是插件标识，读取时是任务 ID |
| 任务结果 | GET /v1/tasks/:key/artifacts | 任务访问权限 |
| 后台审计 | GET /api/audit | AdminAuth 与相应权限 |
Console／Admin 更详细的路由、字段差异和缺口见专项映射。
待设计扩展
子站登录交接、产品服务委托、组织／项目权限、创作资产关系、跨步骤任务、业务费用操作的持久幂等与恢复。每个扩展先确认上游现有能力能否适配，再定义新增 API。
管理员 /models 是前端管理路由，不是给 Developer 直接复用的客户模型目录。详细请求／响应、分页和错误格式在实际对接时从源码和测试固定，不在本表凭空补字段。