查询供应商配置列表 - ListProviders
功能介绍
获取供应商列表，支持分页和多维度筛选。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
workspace:modelProvider:list
List
-
-
-
-
URI
GET /v3/ai-agents/model-providers
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 每页数量，默认10，最大100。 |
| offset | 否 | Integer | 偏移量，默认0。 |
| group_id | 否 | String | 按分组筛选（关联查询）。 |
| status | 否 | String | 状态筛选（connected-已连接，disconnected-已断开，unverified-未验证）。 |
| provider_type | 否 | String | 供应商类型筛选。 |
| name | 否 | String | 名称模糊搜索。 |
请求参数
无
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 总数。 |
| items | Array of ProviderInfoVO objects | 供应商配置列表项。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 供应商id。 |
| provider_name | String | 供应商名称。 |
| provider_type | String | 供应商类型。 |
| provider_id | String | 供应商id。 |
| base_url | String | 供应商base_url。 |
| connection_status | String | 连接状态（connected/disconnected/unverified）。 |
| model_count | Integer | 下属模型数量。 |
| group_count | Integer | 关联的模型分组数量。 |
| last_verify_time | String | 最后一次验证时间。 |
| create_time | String | 创建时间（ISO8601格式，UTC时区）。 |
| update_time | String | 更新时间（ISO8601格式，UTC时区）。 |
| is_builtin | Boolean | 是否为内置供应商。 |
| api_type | String | API协议类型（OpenAI/Anthropic）。 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码，失败时返回。 |
| error_msg | String | 错误描述。 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码，失败时返回。 |
| error_msg | String | 错误描述。 |
状态码：403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码，失败时返回。 |
| error_msg | String | 错误描述。 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码，失败时返回。 |
| error_msg | String | 错误描述。 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码，失败时返回。 |
| error_msg | String | 错误描述。 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 操作成功。 |
| 400 | 由于包含语法错误，当前请求无法被服务器理解。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 404 | 找不到资源。 |
| 500 | 服务内部异常。 |
错误码
请参见错误码。
