查询模型配置列表

查询工作区内的智能体模型配置。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/model-configs

调用前准备

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

请求参数

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/model-configs?model_category=chat&limit=20" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

字段

类型

必填

说明

workspace_id

string

是

当前工作区 ID，必须与 X-Workspace-ID 一致。

字段

类型

必填

说明

status

string

否

按配置状态筛选。

source_kind

string

否

按模型来源类型筛选。

model_category

string

否

按模型类别筛选。

provider_ref

string

否

按提供商引用筛选。

query

string

否

按名称或相关文本查看。

limit

integer

否

返回数量上限。

offset

integer

否

返回偏移量。

成功响应

成功时返回 200。data.items 为模型配置列表；当前筛选没有结果时，服务可能返回 null，调用方应按空列表处理。data.total、data.limit 和 data.offset 描述列表范围。

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "mc_01",
        "name": "销售分析模型",
        "status": "active",
        "source_kind": "workspace",
        "model_category": "chat",
        "model_name": "<MODEL_NAME>",
        "version": 1
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

data.limit

integer

本页请求的最大记录数。

data.offset

integer

本页第一条记录的零基偏移量。

字段

类型

说明

data.items[].status

string

配置状态。

字段

类型

说明

data.total

integer

匹配记录总数。

data.items[].version

integer

配置版本。

字段

类型

说明

data.items

array 或 null

模型配置列表。当前筛选没有结果时，服务可能返回 null；调用方应按空列表处理。

data.items[].id

string

模型配置 ID。

data.items[].name

string

配置名称。

data.items[].source_kind

string

模型来源类型。

data.items[].model_category

string

模型类别。

data.items[].model_name

string

模型名称。

错误响应

{
  "code": 2,
  "message": "模型配置参数无效"
}

字段

类型

说明

code

integer

错误代码。

message

string

面向调用者的错误信息。

后续操作

使用配置 ID 查询模型配置详情。

最后更新于