docs: record D4 integration inputs

This commit is contained in:
wlx committed 2026-08-23 18:12:21 +08:00
1 parent fdf3a328ce
commit 78ed3c1103
11 files changed
+162 -29

No files matched your search

+80
View File
@@ -0,0 +1,80 @@
# D4 密钥与模型目录实施计划
## 一、节点目标
D4 不先追求接入很多供应商,而是建立一条可替换的“MOYI Key → 统一模型目录 → Provider Adapter → Otari/异步任务适配器”链路。
首轮采用 Mock 完成控制面闭环,再选择一个文本/多模态模型和一个异步 3D 模型做真实联调。
开发管理员账号使用用户名 `adimin`;普通用户注册仍使用邀请码 + 邮箱或手机号。管理员密码只在本地 `control-plane/.env` 中配置。
## 二、首批供应商分层
### A. 文本/编码/多模态候选
智谱、阿里、Kimi 等国内模型供应商列为候选,不在代码中写死。真正进入联调前,需要从其中选择至少一个能够提供测试 Key、API 文档和限流说明的供应商。
### B. 3D 候选
VAST 合作方向作为 3D 优先候选;现有信息表明可以通过开发者 API Key/API 文档方式接入,后续再评估 SDK 接入。Tripo 官方 Key 页面说明 API Key 创建后仅展示一次,并建议使用环境变量保存,不要提交到版本控制:[Tripo API 密钥](https://developers.tripo3d.com/zh/keys)。
适配层必须把用户侧协议与上游实现隔离:
```text
用户应用
→ MOYI API Key
→ MOYI 统一模型 ID
→ VAST/3D Provider Adapter
→ 上游 HTTP API 或 SDK
```
SDK 不直接暴露给 MOYI 用户。后续如果上游从 HTTP API 切换为 SDK,只替换 Provider Adapter,不修改用户的 Base URL、MOYI Key 和统一模型名。
## 三、D4 先做 Mock 的内容
- MOYI Key 创建、只显示一次、停用和权限范围。
- 模型目录:文本、代码、多模态、3D 类型和模型能力 Schema。
- 用户/项目/Key 到模型的访问权限。
- 供应商模型 ID 到统一模型 ID 的映射。
- 同步模型和异步模型的调用模式标记。
- 模型上下线和管理端基础页面。
- Otari 模型列表适配接口的 Mock 响应。
## 四、真实联调前的最小资料
### 文本/多模态模型
- 供应商名称和正式 API 文档。
- 测试 Base URL、API Key 和模型 ID。
- 请求/响应样例,是否支持流式。
- 上下文、输入文件、输出长度、超时、速率和并发限制。
- 供应商错误码、余额/额度查询方式和数据使用条款。
### 3D 模型
- VAST 或 AI SoulMate 的 API/SDK 文档。
- 测试 API Key 和测试环境。
- 文生 3D、图生 3D 的任务参数。
- 任务创建、进度查询、Webhook/轮询和取消方式。
- 输出文件格式、文件下载授权、保存周期和大小限制。
- 计费单位、失败/超时/取消规则和重试建议。
## 五、首轮验收建议
按 4—5 人、3—4 个项目的内部测试规模,先验收:
1. 管理员创建 MOYI Key 并限制模型范围。
2. 普通用户使用 MOYI Key 查看可用模型。
3. Mock 文本模型完成一次同步或流式调用。
4. Mock 3D 模型完成任务创建、排队、进度和结果状态闭环。
5. 管理员分配一笔额度或金额预算,并能查看用量。
6. 停用 Key 后调用被拒绝,且产生审计记录。
7. 将 Mock Provider 替换为一个真实供应商时,用户侧配置不变。
## 六、暂不进入 D4
- 真实支付、充值、退款和发票。
- 多供应商智能路由和复杂降级。
- 企业认证、团队审批和 BYOK。
- 正式公网开放、生产 SLA 和大规模并发承诺。
- 自托管模型和 GPU 调度。