查询本地密钥列表

查询当前用户的 TaaS 本地密钥、调用限制和额度，不返回密钥明文。

GET https://billing.moi.matrixorigin.cn/api/v1/taas/token-keys

调用前准备

准备个人访问令牌。创建和管理方法参阅创建和管理个人访问令牌。

查询范围为当前用户有权访问的数据。

查询参数

将示例中的 $MOI_PERSONAL_ACCESS_TOKEN 替换为个人访问令牌。

输入示例

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/token-keys" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN" \
  --data-urlencode "page_size=2"

将响应中的 next_page_token 保存为 $NEXT_PAGE_TOKEN，保持筛选条件不变并请求下一页。该值为空或省略时停止翻页。

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/token-keys" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN" \
  --data-urlencode "page_size=2" \
  --data-urlencode "page_token=$NEXT_PAGE_TOKEN"

参数说明

参数	类型	是否必填	说明
status	string	否	密钥状态筛选；disabled 同时包含 disabled 和 revoked。
name	string	否	按名称包含匹配，不区分大小写。
page_size	integer	否	每页数量，默认 100，最大 1000。
page_token	string	否	上一页返回的下一页标记；首个请求省略。

成功响应

返回 HTTP 200，响应包含当前页的本地密钥记录及分页信息。

响应示例

{
  "items": [],
  "total": 0,
  "next_page_token": ""
}

字段说明

字段	类型	说明
items	array of object	本页记录。
items[].id	string	TaaS 本地密钥 ID。
items[].user_id	string	所属用户 ID。
items[].name	string	密钥名称。
items[].key_prefix	string	密钥前缀。
items[].status	string	密钥状态。
items[].remark	string	密钥备注；有值时返回。
items[].concurrency_limit	integer	并发请求上限。
items[].rpm_limit	integer	每分钟请求上限。
items[].tpm_limit	integer	每分钟 Token 上限。
items[].daily_budget_limit	string	每日额度上限。 有值时返回。
items[].daily_used_quota	string	当日已用额度。 有值时返回。
items[].total_quota	string	总额度上限。 有值时返回。
items[].used_quota	string	累计已用额度。 有值时返回。
items[].remaining_quota	string	剩余额度。 有值时返回。
items[].allowed_models	array of string	允许调用的模型目录对象 ID。
items[].allowed_model_names	array of string	允许模型的显示名称，优先使用别名；有值时返回。
items[].expires_at	integer 或 null	到期时间，Unix 秒；null 表示未设置。
items[].last_called_at	integer 或 null	最近调用时间，Unix 秒；无记录时为 null。
items[].created_at	integer	创建时间，Unix 秒。
items[].updated_at	integer	更新时间，Unix 秒。
total	integer	符合筛选条件的总记录数。
next_page_token	string	下一页标记；为空或省略时已到最后一页。

字段路径中的 [] 表示数组中的每一项。

此列表只包含 TaaS 本地签发的密钥。个人访问令牌和服务账号密钥由访问凭据页面管理。

最后更新于 2026 年 9 月 8 日