列出 API Key

GET /api/open/v1/keys

请求参数

参数	位置	类型	必填	默认值	说明
`p`	query	integer	否	`1`	页码，取值 1–1000000
`page_size`	query	integer	否	`10`	每页条数，取值 1–1000
`name`	query	string	否	—	按 Key 名称精确过滤；多值需重复参数（`?name=a&name=b`），不支持逗号分隔（名称本身可能含逗号）

多值参数每个最多 50 个值，超过返回 400 invalid_request。传 name 时 total 为过滤后的数量。p / page_size 显式传入非法值返回 400，详见分页。

请求示例

curl "https://www.routeapi.ai/api/open/v1/keys?p=1&page_size=20&name=bot" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": 12,
        "name": "bot",
        "key": "sk-abcd**********wxyz",
        "status": 1,
        "created_time": 1729000000,
        "accessed_time": 1729000000,
        "expired_time": -1,
        "remain_amount": 10.00,
        "unlimited": false,
        "used_amount": 0.00,
        "model_limits_enabled": true,
        "model_limits": "gpt-4o,gpt-4o-mini",
        "allow_ips": ""
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}

响应字段

字段	类型	说明
`items`	array	Key 对象列表，按 ID 倒序（最新在前）
`total`	integer	符合过滤条件的 Key 总数
`page`	integer	当前页码
`page_size`	integer	实际生效的每页条数

Key 对象

开放平台 API 中所有返回 Key 的接口都使用同一结构：

字段	类型	说明
`id`	integer	Key ID，用于其他接口的 `:id`
`name`	string	名称
`key`	string	Key 值，`sk-` 前缀；除创建接口与获取完整 API Key 外均为脱敏值
`status`	integer	`1` 启用、`2` 已禁用（手动禁用，可重新启用）、`3` 已过期、`4` 已耗尽；通过修改接口启用/禁用（只接受 `1` / `2`）
`created_time`	integer	创建时间，unix 秒
`accessed_time`	integer	最近使用时间，unix 秒
`expired_time`	integer	过期时间，unix 秒；`-1` 表示永不过期
`remain_amount`	number	剩余可用金额，两位小数；`unlimited` 为 `true` 时无意义
`unlimited`	boolean	是否无限额度
`used_amount`	number	已用金额，两位小数
`model_limits_enabled`	boolean	是否启用模型白名单
`model_limits`	string	允许的模型，英文逗号分隔
`allow_ips`	string	允许的 IP，换行分隔；空字符串表示不限制

说明

金额使用站点展示币种，见查询余额。
通用错误码见开放平台 API 错误。