查询可用模型¶

查询当前工作区可选择的模型名称及其后端信息，供智能体调用和工作流模型选择使用。本接口不返回提供商凭据。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/llm/models

调用前准备¶

准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求示例¶

$WORKSPACE_ID 为目标工作区 ID，$AI_STUDIO_API_KEY 为调用凭据。

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/llm/models?type=chat" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

路径参数¶

参数	类型	是否必填	说明
`workspace_id`	string	是	目标工作区 ID，必须与工作区请求头一致。

查询参数¶

参数	类型	是否必填	说明
`type`	string	否	模型类型；选择生成工作流的模型时填写 `chat`。
`service_slot`	string	否	AI 服务槽位 ID；指定后按该槽位的配置筛选模型。

本接口返回模型列表，不使用分页参数。模型出现在列表中不表示本次推理已经执行成功。

成功响应¶

成功时返回当前身份可见的模型。模型名称用于调用请求，后端 ID 用于区分模型来源。

{
  "code": 0,
  "data": {
    "models": [
      {
        "model": "qwen3-coder-plus",
        "backend_id": -900001,
        "backend_name": "Genesis",
        "model_type": "chat"
      }
    ]
  }
}

响应字段如下。

字段	类型	说明
`code`	integer	成功时为 `0`。
`data`	object	查询结果。
`data.models`	object[]（对象数组）	当前可见的模型列表。
`data.models[].model`	string	调用时使用的模型名称。
`data.models[].backend_id`	integer	模型后端 ID。
`data.models[].backend_name`	string	模型后端名称。
`data.models[].model_type`	string	模型类型；有值时返回。

字段路径中的 [] 表示数组中的每一项。例如，data.models[].model 表示每个模型的名称。类型后的 [] 表示数组，例如 object[] 是对象数组。

查询模型配置列表返回的是已保存的智能体模型配置，不能代替本接口。模型配置列表为空时，当前工作区仍可能有可调用模型。

后续操作¶

选择一项，将 data.models[].model 用于由其他智能体调用的 params.model。需要生成工作流时，继续通过 API 用自然语言搭建工作流。

最后更新于 2026 年 9 月 15 日