工作区 API 基址与鉴权¶

工作区运行时请求都相对于统一基址构造，并使用工作区 API Key 鉴权。不要把 Genesis Bearer Key、浏览器 Cookie 或其他产品凭据当作可互换项。各接口页另有独立的「请求方式」；本页说明共用基址与鉴权。

请求方式¶

按具体接口页为准（如 GET / POST / PATCH / DELETE）。下方示例使用 GET。

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>

前端控制台入口形态为 https://moi.matrixorigin.cn/<workspace_id>/agent，与 API 基址不同，不要互相拼接。

身份认证¶

X-API-Key: <WORKSPACE_API_KEY>
Content-Type: application/json

请求示例¶

curl 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/agents/<agent_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

使用限制¶

仅在工作区运行时 API 使用 X-API-Key。
Genesis 模型请求使用 Authorization: Bearer <API_KEY>，见 Genesis 模型。
不要在文档、源码、日志或截图中写入真实工作区 API Key。

相关接口¶