# API

通过 HTTP 调用 Genesis 模型或 MatrixOne Intelligence 产品能力。两类 API 使用不同的服务地址、凭据和资源模型；调用前先确认目标分类，不要混用 Base URL 或认证 Header。

## 选择 API

| 你的目标 | 使用的 API | 下一步 |
| --- | --- | --- |
| 在应用中调用文本、图文、向量或重排序模型 | Genesis 模型 API | [调用 Genesis 模型 API](genesis-model-api/index.md) |
| 管理工作区、数据、工作流、智能体和计算实例等产品资源 | Product API | [调用 Product API](product-api/index.md) |
| 接入自动化、智能体构建、技能、工具、MCP 或事件回调 | 集成与扩展 API | [查看集成与扩展 API](integrations/index.md) |
| 统一处理认证、请求格式、分页、重试和状态码 | API 通用规则 | [查看 API 通用规则](common/index.md) |

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

## API、SDK 与 CLI 的边界

- 使用 API，在任何能够发送 HTTP 请求的语言或运行环境中直接调用服务。
- 使用 [SDK](../sdk/index.md)，通过语言客户端在应用代码中调用服务。
- 使用 [CLI](../cli/index.md)，在终端中执行产品任务或编写自动化脚本。

选择一种入口后，继续使用该入口对应的服务地址和认证方式；不要混用不同入口的客户端、Base URL 或凭据。

```{toctree}
:hidden:
:maxdepth: 1

Genesis 模型 API <genesis-model-api/index>
Product API <product-api/index>
集成与扩展 <integrations/index>
API 通用规则 <common/index>
```