# 查询本地密钥列表

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

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

## 调用前准备

准备个人访问令牌。创建和管理方法参阅[创建和管理个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。

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

## 查询参数

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

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
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`，保持筛选条件不变并请求下一页。该值为空或省略时停止翻页。

```bash
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"
```

:::::
:::::{tab-item} 参数说明

::::{div} mo-api-parameter-table

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

::::

:::::
::::::
:::::::

## 成功响应

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

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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 本地签发的密钥。个人访问令牌和服务账号密钥由访问凭据页面管理。