> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 搜索令牌

> 按关键词搜索令牌

> 更新日期：2026-06-06

## 接口说明

根据关键词搜索令牌，支持按名称模糊匹配，也支持按 token 片段过滤。

<Note>
  这组 `/api/token/*` 接口主要用于 Crazyrouter 控制台中的 API Key 管理自动化。它们需要用户 `access token` 与 `New-Api-User` 请求头，不是给普通 `sk-xxx` 模型调用流程直接使用的接口。
</Note>

## 认证方式

使用用户侧认证，请在请求头中携带：

```text theme={null}
Authorization: Bearer your_access_token
New-Api-User: 1
```

## 请求参数

<ParamField query="keyword" type="string" required>
  搜索关键词，匹配令牌名称
</ParamField>

<ParamField query="token" type="string">
  可选。按 token 字符串片段过滤
</ParamField>

## 响应格式

```json theme={null}
{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 5,
      "name": "生产环境",
      "key": "sk-xxxxxxxx",
      "status": 1,
      "remain_quota": 50000,
      "used_quota": 8000,
      "created_time": 1706000000,
      "model_limits_enabled": false,
      "model_limits": "",
      "allow_ips": "",
      "group": "default"
    }
  ]
}
```

## 代码示例

<CodeGroup>
  ```python Python theme={null}
  import requests

  headers = {
      "Authorization": "Bearer your_access_token",
      "New-Api-User": "1",
      "User-Agent": "Mozilla/5.0"
  }

  response = requests.get(
      "https://api.crazyrouter.com/api/token/search?keyword=生产&token=sk-",
      headers=headers
  )

  tokens = response.json()["data"]
  for token in tokens:
      print(f"[{token['id']}] {token['name']} - 剩余额度: {token['remain_quota']}")
  ```

  ```bash cURL theme={null}
  curl "https://api.crazyrouter.com/api/token/search?keyword=生产&token=sk-" \
    -H "Authorization: Bearer your_access_token" \
    -H "New-Api-User: 1"
  ```
</CodeGroup>