`POST https://ark.cn-beijing.volcengineapi.com/?Action=ListEndpoints&Version=2024-01-01` 分页查询推理接入点列表，支持按项目、标签、模型、状态等多维度筛选。

注意

本接口仅返回调用方有权限查看的项目下的接入点；跨项目检索请确认已切换或显式指定 ProjectName。返回字段为精简版接入点信息（ListEndpointItem），如需完整配置请通过 GetEndpoint 接口按 ID 查询。

## 鉴权本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](https://docs.volcengine.com/docs/82379/1298459)。 * Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。 --- ## 请求参数 ### Body 参数 **Filter** `object` | 接入点筛选条件接入点筛选条件，各子字段之间为「与」关系。格式如下：`{ "Statuses": ["Running"], "FoundationModelName": "doubao-seed-2-1-pro-260628" }`。 **CustomModelIds** `string[]` | 定制模型 ID 筛选 `Filter.CustomModelIds` 按定制模型 ID 列表精确筛选。 **Domain** `string` | 接入点类型筛选 `Filter.Domain` 按接入点类型筛选。可选值： * `Ark` * `Mlp` **EndpointModelTypes** `string[]` | 模型类型筛选 `Filter.EndpointModelTypes` 按接入模型类型筛选。可选值： * `FoundationModel` * `CustomModel` * `ServiceModel` **FoundationModelName** `string` | 基础模型名称筛选 `Filter.FoundationModelName` 按基础模型名称模糊匹配。 **Ids** `string[]` | 接入点 ID 筛选 `Filter.Ids` 按接入点 ID 列表精确筛选。 **ModelOrServiceName** `string` | 模型/服务名称筛选 `Filter.ModelOrServiceName` 按模型名称或 MLP 服务名称模糊匹配。 **ModelVersions** `string[]` | 模型版本筛选 `Filter.ModelVersions` 按基础模型版本列表精确筛选。 **Name** `string` | 接入点名称筛选 `Filter.Name` 按接入点名称模糊匹配。 **PaymentType** `string` | 付费方式筛选 `Filter.PaymentType` 按付费方式筛选。可选值： * `ModelUnit`：模型单元。 * `ScaleTier`：TPM 保障包。 * 不传或为空：不区分付费方式 **ServiceInfoIds** `string[]` | MLP 服务 ID 筛选 `Filter.ServiceInfoIds` 按 MLP 推理服务 ID 列表筛选，仅 *Domain* 为 `Mlp` 时有效。 **Statuses** `string[]` | 状态筛选 `Filter.Statuses` 按接入点状态筛选。可选值： * `Running` * `Scheduling` * `Abnormal` * `Stopped` **PageNumber** `integer` `默认值 1` | 起始页码分页查询时的页码，从 1 开始。 **PageSize** `integer` `默认值 10` | 每页记录数分页查询时每页显示的记录数，取值范围 1~100。 **ProjectName** `string` `默认值 default` | 项目名称按项目名称过滤接入点，精确匹配。 **SortBy** `string` `默认值 CreateTime` | 排序字段排序字段。可选值： * `CreateTime`（默认）：创建时间。 * `UpdateTime`：更新时间。 **SortOrder** `string` `默认值 Desc` | 排序顺序排序顺序。可选值： * `Asc`：升序。 * `Desc`（默认）：降序。 **TagFilters** `object[]` | 标签筛选条件按标签筛选接入点，多条之间为「与」关系，同一 *Key* 的多个 *Values* 之间为「或」关系。格式如下：`[ { "Key": "env", "Values": ["stg", "boe"] } ]`。 **Key** `string` `必选` | 标签键 `TagFilters.Key` 标签键，长度 1~64 字符。 **Values** `string[]` | 标签值列表 `TagFilters.Values` 标签值列表；为空时表示该 *Key* 下所有标签值均匹配。 ## 响应参数 **Items** `object[]` | 接入点列表接入点列表，数组每个元素为一个接入点的精简信息。格式如下：`[ { "Id": "ep-20260507230659-skvgn", "Name": "curl_bot_test", "Status": "Running" } ]`。 **CreateTime** `string` | 创建时间 `Items.CreateTime` 创建时间，RFC3339 格式。 **EndpointModelType** `string` | 模型类型 `Items.EndpointModelType` 接入模型类型。可选值： * `FoundationModel` * `CustomModel` * `ServiceModel` **Id** `string` | 接入点 ID `Items.Id` 推理接入点 ID。 **ModelReference** `object` | 模型引用 `Items.ModelReference` 接入模型引用。格式如下：`{ "FoundationModel": { "Name": "doubao-seed-2-1-pro-260628", "ModelVersion": "250615" } }`。 **CustomModelId** `string` | 定制模型 ID `Items.ModelReference.CustomModelId` 定制模型 ID，以 `cm-` 开头。 **FoundationModel** `object` | 基础模型引用 `Items.ModelReference.FoundationModel` **ModelVersion** `string` | 模型版本 `Items.ModelReference.FoundationModel.ModelVersion` 基础模型版本号。 **Name** `string` | 基础模型名称 `Items.ModelReference.FoundationModel.Name` **Name** `string` | 接入点名称 `Items.Name` **ProjectName** `string` | 项目名称 `Items.ProjectName` **RateLimit** `object` | 限流配置 `Items.RateLimit` 限流配置。格式如下：`{ "Rpm": 600, "Tpm": 100000 }`。 **Rpm** `integer` | 每分钟请求数 `Items.RateLimit.Rpm` 每分钟请求数上限。 **Tpm** `integer` | 每分钟 Token 数 `Items.RateLimit.Tpm` 每分钟 token 数上限。 **Ipm** `integer` | 每分钟图片数 `Items.RateLimit.Ipm` 每分钟生成图片数上限。 **Status** `string` | 接入点状态 `Items.Status` 接入点状态。可选值： * `Running` * `Scheduling` * `Abnormal` * `Stopped` **Tags** `object[]` | 标签列表 `Items.Tags` 接入点绑定的标签列表。 **Key** `string` | 标签键 `Items.Tags.Key` **Value** `string` | 标签值 `Items.Tags.Value` **UpdateTime** `string` | 更新时间 `Items.UpdateTime` 更新时间，RFC3339 格式。 **ContentGeneration** `object` | 生图/生视频配置 `Items.ContentGeneration` 生图 / 生视频模型的特化配置。格式如下：`{ "ConcurrentRequests": 10, "CreateTaskRpm": 60 }`。 **ConcurrentRequests** `number` | 并发请求数 `Items.ContentGeneration.ConcurrentRequests` 并发请求数上限。 **CreateTaskRpm** `number` | 每分钟创建任务数 `Items.ContentGeneration.CreateTaskRpm` 每分钟创建任务数上限。 **Description** `string` | 接入点描述 `Items.Description` **ModelUnitId** `string` | 模型单元 ID `Items.ModelUnitId` 模型单元（PTU）ID，以 `ptu-` 开头。 **PaymentType** `string` | 付费方式 `Items.PaymentType` 付费方式。可选值： * `ModelUnit`：模型单元。 * `ScaleTier`：TPM 保障包。 * 不传或为空：按 Token 付费 **StatusReason** `string` | 状态说明 `Items.StatusReason` 状态附加说明。 **PageNumber** `integer` | 当前页码当前返回的页码，与请求参数 *PageNumber* 一致。 **PageSize** `integer` | 每页记录数当前返回的每页记录数，与请求参数 *PageSize* 一致。 **TotalCount** `integer` | 接入点总数满足筛选条件的接入点总数。

火山方舟