# 开发者平台

MOI 开发者平台提供两类接入能力：一类用于调用模型，另一类用于操作工作区中的产品资源。开始开发前先确认目标属于哪一类，因为两类能力使用不同的 Base URL、凭据、认证 Header 和资源作用域。

## 两条接入路径

| 接入目标 | 主要对象 | 使用入口 |
| --- | --- | --- |
| 调用模型 | 模型、对话、向量、重排序 | [Genesis 模型 API](../api/genesis-model-api/index.md) 或 [Genesis 兼容 SDK](../sdk/genesis-compatible/index.md) |
| 操作产品资源 | 工作区、数据、工作流、知识库、智能体和计算实例 | [Product API](../api/product-api/index.md)、[Product SDK](../sdk/product-sdk/index.md) 或 [MOI-CLI](../cli/index.md) |

Genesis 模型调用不以 Product 工作区为请求作用域。Product 中的 Provider、Backend 和 Router 用于配置产品内部使用的模型服务，也不替代 Genesis 的模型列表或推理接口。

## 工作区中的对象关系

工作区是产品资源的主要治理边界，承载工作区成员、角色、数据、工作流和资源。开发者通常按下面的关系取得并使用对象 ID：

```text
工作区
├─ 工作区成员（关联用户账号）与角色
├─ 目录 → 数据库 → 表或卷 → 文件
├─ 连接器 → 导入任务 → 导入运行
├─ 工作流 → 工作流作业 → 工作流产物与数据血缘
├─ 知识库 → 知识来源与语义配置
├─ 智能体 → 会话或自动化任务 → 智能体产物
└─ 计算实例、数据发布与数据订阅
```

用户账号是平台级登录身份；工作区成员是该账号在某个工作区中的成员身份。删除工作区成员只解除当前工作区关系，不等同于删除用户账号。

## 第一次接入的顺序

1. 根据任务选择 Genesis 或 Product 接入路径。
2. 从当前环境取得对应的完整 Base URL 和凭据。
3. 先执行只读发现：Genesis 列出模型，Product 列出工作区。
4. 保存服务端返回的模型、工作区或资源 ID。
5. 再进入创建、部署、运行、导入、发布或删除等写操作。

## 下一步

- [选择 API、SDK 或 CLI](choose-api-sdk-cli.md)
- [了解产品能力与接口边界](product-capabilities-boundaries.md)
- [完成第一次调用](../quickstart/index.md)