/v1。控制台使用的 /api、/auth 和 /web-api 路由不是公共 SDK 合同。
前置条件
调用前需要一个可访问的 OMA 部署和工作区 API 密钥。智能体执行还需要 PostgreSQL、S3 兼容对象存储和可用的环境运行器。推理前需在工作区的 LLM 模型 页面添加 Provider 及其真实模型 ID。第一个请求
X-Api-Key：
客户端 SDK
OMA 支持通过基础 URL 与 API 密钥配置兼容 SDK。当前仓库持续使用 Go、Python 和 TypeScript SDK 测试核心资源；其他语言可以直接使用 HTTP。通用请求头
核心资源
模型
查询当前工作区公开的模型 ID。
消息
发送模型请求，并通过其下的批处理接口执行大规模异步任务。
智能体
管理可版本化的模型、工具和提示定义。
会话
创建有状态任务，并管理会话事件、资源、线程和线程事件流。
环境
管理沙箱环境、worker 和运行时配置。
文件
管理输入文件和任务产物。
技能
管理可复用技能及其版本。
部署
管理可重复运行的部署和部署运行。
记忆存储
管理记忆存储、记忆条目和记忆版本。
密钥库
管理密钥库及其凭据。
Webhooks
向外部系统发送状态事件。
/v1/organizations 与文件存储服务是管理或运行时合同，不属于面向应用开发者的核心参考。
响应和追踪
成功响应使用 JSON。服务会在响应头和错误体中返回request-id，用于关联服务端日志。
限制与可用性
OMA 没有一个全局固定的公共速率层级。请求并发、文件容量、批处理 worker、环境运行器、沙箱和上游模型限额由部署配置与基础设施共同决定。客户端仍应处理429、临时 5xx、长时间 SSE 和网络中断。
自托管 OMA 的可用区域、入口地址、服务层级和 SLA 均由你的部署决定。