You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
管理推理接入点(Endpoint)
获取推理接入点列表
复制全文
下载 pdf
获取推理接入点列表
POST https://ark.cn-beijing.volcengineapi.com/?Action=ListEndpoints&Version=2024-01-01​
分页查询推理接入点列表,支持按项目、标签、模型、状态等多维度筛选。​
注意​
本接口仅返回调用方有权限查看的项目下的接入点;跨项目检索请确认已切换或显式指定 ProjectName。返回字段为精简版接入点信息(ListEndpointItem),如需完整配置请通过 GetEndpoint 接口按 ID 查询。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
Filter object | 接入点筛选条件​
​
PageNumber integer 默认值 1 | 起始页码​
​
PageSize integer 默认值 10 | 每页记录数​
​
ProjectName string 默认值 default | 项目名称​
​
SortBy string 默认值 CreateTime | 排序字段​
​
SortOrder string 默认值 Desc | 排序顺序​
​
TagFilters object[] | 标签筛选条件​
​
​
响应参数​
Items object[] | 接入点列表​
​
PageNumber integer | 当前页码​
​
PageSize integer | 每页记录数​
​
TotalCount integer | 接入点总数​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=ListEndpoints&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<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": ""
      }
    ]
  }
}
最近更新时间:2026.09.04 20:17:04
这个页面对您有帮助吗?
有用
有用
无用
无用