创建数据侧空知识库¶

创建不含数据源的知识库。创建成功后，再上传并添加文件或数据表。

POST https://moi.matrixorigin.cn/newmoi/semantic-models/create-empty

调用前准备¶

准备有目标工作区创建知识库权限的个人访问令牌和工作区 ID。示例使用 $AI_STUDIO_API_KEY 和 $WORKSPACE_ID。

请求体¶

字段	类型	是否必填	说明
`name`	string	是	知识库名称。
`description`	string	否	知识库说明。
`image_index_enabled`	boolean	否	是否启用图片索引；未传时为 `false`。

请求示例¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/semantic-models/create-empty" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "product_docs",
    "description": "产品资料",
    "image_index_enabled": false
  }'

成功响应¶

成功时返回 201。保存 data.model.id，后续接口将它作为 model_id 使用。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "model": {
      "id": 401,
      "name": "product_docs",
      "tables": []
    },
    "data_domain": {
      "model_id": 401,
      "ensure_status": "ready"
    }
  }
}

字段	类型	说明
`data.model`	object	新建的知识库。
`data.model.id`	integer	知识库 ID。
`data.data_domain`	object	该知识库的数据域信息。
`data.data_domain.ensure_status`	string	数据域准备状态。

常见错误¶

HTTP 状态码	错误代码	常见原因	建议操作
`400`	`ErrParamInvalid`	`name` 缺失或请求体无效。	提供非空名称并检查 JSON。
`401`	`ErrUnauthorized`	API Key 无效或已失效。	检查 API Key。
`403`	`ErrForbidden`	没有工作区创建权限。	检查工作区授权。

后续操作¶

使用 data.model.id 上传本地文件或添加数据源。

最后更新于 2026 年 8 月 22 日