# 查询可用模型列表

`GET` `/api/agent/models`

查询当前租户下可选的模型列表，含模型ID、上下文窗口、最大输出token及输入模态等元数据。inputModalities可选值：TEXT、IMAGE、VIDEO，调用方应使用该字段判断模型是否支持图片或视频输入。原supportVision字段已废弃但暂时保留，新调用方不应继续依赖该字段。同时返回服务端建议预选的 selectedModelName（恒非空），前端下拉框应直接用该值预选。元数据字段可能为空（供应商未配置时），前端渲染需容错。可选传入 agentId：传入且可解析时 selectedModelName 为该智能体的有效模型，否则回落为系统默认。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 否 | 智能体ID，可选；传入后按该智能体的有效模型建议预选 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | ModelListResult | 响应数据 |
|     selectedModelName | string | - |
|     models | array | - |
|         modelName | string | - |
|         contextWindow | integer | - |
|         maxOutputTokens | integer | - |
|         supportVision | boolean | - |
|         inputModalities | array | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |