选择开发方式¶

先按任务选模型调用或资源管理，再按运行位置和所需控制程度选 API、SDK 或 CLI。

快速选择¶

你要完成的任务	建议方式	原因
从应用调用模型对话、Responses、向量或重排序	Genesis 模型 API	直接使用对应的模型接口和响应形态。
使用现有 OpenAI 或 Anthropic 客户端调用兼容接口	OpenAI SDK / Anthropic SDK	保留熟悉的 SDK 调用方式，同时使用 Genesis 服务地址和凭据。
精确控制 HTTP 方法、Header、字段和响应	AI Studio API	适合服务间集成、Webhook 和没有 SDK 封装的接口。
在 Go 或 Python 应用中操作工作区资源	AI Studio SDK	提供类型化客户端、工作区范围对象和任务封装。
在终端、运维脚本或 CI 中操作工作区资源	`moi-cli`	适合交互式操作和自动化，不用于调用 Genesis 模型。

接入配置¶

API¶

API	服务地址	凭据与适用范围
Genesis 模型 API	控制台「使用」页复制的完整 Genesis 服务地址	Bearer 凭据；模型 ID 来自当前凭据的模型列表。
AI Studio API	`https://api.moi.matrixorigin.cn/v5`	`X-API-Key` 传递个人访问令牌；工作区资源还需工作区 ID。

SDK¶

SDK	服务地址	凭据与适用范围
OpenAI SDK	控制台「使用」页复制的完整 Genesis 服务地址	Bearer 凭据；模型 ID 来自当前凭据的模型列表。
Anthropic SDK	按 Anthropic SDK 页面从 Genesis 地址配置 origin/root；SDK 会自行追加 Messages 路径	使用 `auth_token` 传入 Genesis 访问凭据，并按接口要求设置 Anthropic 版本。
AI Studio SDK	与 AI Studio API 相同的服务地址	个人访问令牌；先列出工作区，再创建工作区范围对象。

CLI¶

CLI	服务地址	凭据与适用范围
`moi-cli`	与 AI Studio API 相同的服务地址	个人访问令牌；先运行 `workspace list`，再保存工作区 ID。

moi-cli 不用于调用 Genesis 模型。AI Studio SDK 也不是 OpenAI 或 Anthropic 兼容 SDK；它操作的是工作区范围内的资源。

仍然无法确定时¶

需要核对准确 HTTP 契约时，从 AI Studio API 或 Genesis 接口参考开始。
需要在应用中串联多个资源对象时，优先评估 AI Studio SDK 是否已有对应任务封装。
需要交互式检查或把少量命令放入脚本时，使用 moi-cli。
SDK 或 CLI 没有对应能力时，回到 AI Studio API，不根据命令名或方法名猜测接口。

调用前确认¶

页面是否已经为该对象提供公开 API、SDK 方法或 CLI 命令。
操作修改的是定义对象，还是创建一次异步运行。
成功响应中需要保存对象 ID、运行 ID 还是请求 ID。
后续应查询哪个状态或结果接口，以及什么结果才算业务完成。
删除、取消、重试或重新提交是否可能留下外部副作用。

未在开发者文档中列出的界面功能，不应根据网页请求、内部路径或相似命令推断为稳定公开接口。

下一步¶

调用 Genesis 模型：

调用 API

管理 AI Studio 资源：

最后更新于 2026 年 9 月 28 日