# 获取推理接入点列表
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
`POST https://ark.cn-beijing.volcengineapi.com/?Action=ListEndpoints&Version=2024-01-01`
分页查询推理接入点列表，支持按项目、标签、模型、状态等多维度筛选。
> **说明：注意**
>
> 本接口仅返回调用方有权限查看的项目下的接入点；跨项目检索请确认已切换或显式指定 *ProjectName*。返回字段为精简版接入点信息（*ListEndpointItem*），如需完整配置请通过 *GetEndpoint* 接口按 ID 查询。
## 鉴权
本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。
* 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` | 接入点总数
满足筛选条件的接入点总数。
## 代码示例
## 默认
### cURL
#### Request
```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=ListEndpoints&Version=2024-01-01' \
-H 'Content-Type: application/json' \
-H 'X-Date: ' \
-H 'X-Content-Sha256: ' \
-H 'Authorization: HMAC-SHA256 Credential=//cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=' \
-d '{
"PageNumber": 1,
"PageSize": 10,
"ProjectName": "default",
"TagFilters": [
{
"Key": "env",
"Values": [
"prod"
]
}
],
"Filter": {
"EndpointModelTypes": [
"FoundationModel"
],
"Statuses": [
"Running"
],
"ModelVersions": [
"doubao-seed-2-1-pro"
],
"CustomModelIds": [
"mcm-20260507230659-abcde"
],
"FoundationModelName": "doubao-seed",
"Ids": [
"ep-20260507230659-skvgn"
],
"Name": "my-endpoint"
},
"SortBy": "CreateTime",
"SortOrder": "Desc"
}
'
```
#### Response
```
{
"ResponseMetadata": {
"RequestId": "20240514213143172211079122D5C1C8",
"Action": "ListEndpoints",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"TotalCount": 1,
"PageNumber": 1,
"PageSize": 10,
"Items": [
{
"Id": "ep-20260507230659-skvgn",
"Name": "curl_bot_test",
"Description": "用于电商场景的图像生成接入点",
"ProjectName": "default",
"Tags": [
{
"Key": "env",
"Value": "stg"
}
],
"ModelReference": {
"CustomModelId": "",
"FoundationModel": {
"Name": "doubao-seed-2-0-pro",
"ModelVersion": "260215"
}
},
"EndpointModelType": "FoundationModel",
"ModelUnitId": "ptu-20260227200531-pwbpk",
"Status": "Running",
"UpdateTime": "2026-05-07T23:06:59Z",
"CreateTime": "2026-05-07T23:06:59Z",
"RateLimit": {
"Rpm": 600,
"Tpm": 100000
},
"StatusReason": ""
}
]
}
}
```