选择开发方式：API、SDK 或 CLI¶
先按任务选择模型调用或产品资源操作，再根据运行位置和所需控制程度选择 API、SDK 或 CLI。
快速选择¶
你要完成的任务 |
建议方式 |
原因 |
|---|---|---|
从应用调用模型对话、Responses、向量或重排序 |
Genesis 模型 API |
直接使用对应的模型接口和响应形态。 |
使用现有 OpenAI 或 Anthropic 客户端调用兼容接口 |
Genesis 兼容 SDK |
保留熟悉的 SDK 调用方式，同时使用 Genesis Base URL 和凭据。 |
精确控制 Product HTTP 方法、Header、字段和响应 |
Product API |
适合服务间集成、Webhook 和没有 SDK 封装的接口。 |
在 Go 或 Python 应用中操作工作区资源 |
Product SDK |
提供类型化客户端、工作区作用域对象和任务封装。正式分发入口可用后再从零安装。 |
在终端、运维脚本或 CI 中操作工作区资源 |
|
适合命令发现、JSON 输出和短流程自动化。正式分发入口可用后再从零安装。 |
接入配置不能混用¶
方式 |
Base URL |
凭据与作用域 |
|---|---|---|
Genesis 模型 API / OpenAI SDK |
控制台「使用」页复制的完整 Genesis Base URL |
Bearer 凭据；模型 ID 来自当前凭据的模型列表。 |
Anthropic SDK |
按 Anthropic SDK 页面从 Genesis 地址配置 origin/root；SDK 会自行追加 Messages 路径 |
使用 |
Product API |
包含 |
|
Product SDK |
与 Product API 相同的完整 Product Endpoint |
PAT；先列出工作区，再创建工作区作用域对象。 |
|
与 Product API 相同的完整 Product Endpoint |
PAT；先运行 |
moi-cli 不用于调用 Genesis 模型。Product SDK 也不是 OpenAI 或 Anthropic 兼容 SDK；它操作的是工作区范围内的产品资源。
仍然无法确定时¶
需要核对准确 HTTP 契约时，从 Product API 或 Genesis 接口参考开始。
需要在应用中串联多个 Product 对象时，优先评估 Product SDK 是否已有对应任务封装。
需要交互式检查或把少量命令放入脚本时，使用
moi-cli。SDK 或 CLI 没有对应能力时，回到 Product API，不根据命令名或方法名猜测接口。