查询可用模型

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

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

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

输入示例

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 为目标工作区 ID，$AI_STUDIO_API_KEY 为调用凭据。

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

查询参数

类型参数用于筛选模型类型。此接口不会测试模型能力，列表中的模型仍可能无法完成相应推理。

参数	类型	是否必填	说明
type	string	否	模型类型，默认 chat。支持 chat、vision、ocr、reasoning、embedding 和 rerank。此接口对 embedding、rerank 返回空列表。

本接口不使用分页参数。

成功响应

响应示例

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

字段说明

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
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 用于通过 A2A 调用智能体的 params.model。

最后更新于 2026 年 11 月 3 日