文档首页/ 云桌面 Workspace/ API参考/ 云桌面API/ 模型管理/ 查询模型列表 - ListModels
更新时间：2026-07-24 GMT+08:00
查看PDF
分享

查询模型列表 - ListModels

功能介绍

获取指定供应商下的模型列表，支持分页。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    workspace:modelProvider:listModel

    List

    -

    -

    -

    -

URI

GET /v3/ai-agents/model-providers/{provider_id}/models

表1 路径参数

参数

是否必选

参数类型

描述

provider_id

是

String

供应商id。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页数量，默认10。

offset

否

Integer

偏移量，默认0。

group_id

否

String

分组ID筛选。

name

否

String

名称模糊搜索。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

总数。

items

Array of ModelInfoForListResp objects

模型列表项。
表4 ModelInfoForListResp

参数

参数类型

描述

id

String

模型id。

name

String

模型名称。

input

Array of strings

输入类型数组。

context_window

Integer

最大上下文窗口。

max_tokens

Integer

最大输出Token数。

reasoning

Boolean

是否支持推理。

cost

ModelCost object

费用信息。

compat

ModelCompat object

兼容性配置。

is_builtin

Boolean

是否内置模型。

provider_model_id

String

供应商侧模型标识。

provider_id

String

供应商id。

provider_name

String

供应商名称。

description

String

模型描述。

priority

Integer

组内排序优先级。

create_time

String

创建时间。

update_time

String

更新时间。

group_count

Long

关联为默认模型的模型分组数
表5 ModelCost

参数

参数类型

描述

input

Double

每百万输入Token费用。

output

Double

每百万输出Token费用。

cache_read

Double

每百万缓存读取Token费用。

cache_write

Double

每百万缓存写入Token费用。
表6 ModelCompat

参数

参数类型

描述

supports_usage_streaming

Boolean

是否支持使用量流式传输。

supports_developer_role

Boolean

是否支持开发者角色。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码，失败时返回。

error_msg

String

错误描述。

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码，失败时返回。

error_msg

String

错误描述。

状态码：403

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码，失败时返回。

error_msg

String

错误描述。

状态码：500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码，失败时返回。

error_msg

String

错误描述。

请求示例

无

响应示例

无

状态码

状态码

描述

200

操作成功。

400

由于包含语法错误，当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

500

服务内部异常。

错误码

请参见错误码。

父主题： 模型管理