# 查询可用模型

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

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

## 调用前准备

准备具有目标工作区访问权限的[个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)和[目标工作区 ID](../../../../../guides/ai-studio/resource-center/workspace.md#复制工作区-id)。

## 请求示例

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

```bash
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 用于区分模型来源。

```json
{
  "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[]` 是对象数组。

[查询模型配置列表](list-model-configurations.md)返回的是已保存的智能体模型配置，不能代替本接口。模型配置列表为空时，当前工作区仍可能有可调用模型。

## 后续操作

选择一项，将 `data.models[].model` 用于[由其他智能体调用](../agent-invocation/call-agent-from-agent.md)的 `params.model`。需要生成工作流时，继续[通过 API 用自然语言搭建工作流](../../data-processing/workflows/build-with-api.md)。