本页接口使用系统访问令牌鉴权。创建出来的 sk-... 令牌用于调用模型 API，两者不能混用。

方法路径用途
GET/api/token/分页列出自己的 API 令牌
GET/api/token/:id获取指定令牌的配置
GET/api/token/search按名称或 Key 前缀搜索
POST/api/token/创建 API 令牌
PUT/api/token/更新令牌配置或状态
DELETE/api/token/:id删除指定令牌
POST/api/token/batch批量删除令牌
GET/api/usage/token/使用模型 API 令牌查询自身用量

创建令牌

curl -X POST https://top.qingyuntop.ai/dashboard//api/token/ \
  -H "Authorization: Bearer $青云TOP API_ACCESS_TOKEN" \
  -H "New-Api-User: $青云TOP API_USER_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "expired_time": -1,
    "remain_quota": 0,
    "unlimited_quota": true,
    "model_limits_enabled": false,
    "group": ""
  }'

令牌常用配置包括过期时间、剩余额度、无限额度、模型白名单、IP 白名单、分组和跨分组重试。创建后立即保存完整 Key，列表和详情接口可能只返回脱敏值。

查询令牌自身用量

GET /api/usage/token/ 是例外，它使用需要查询的模型 API 令牌：

curl https://top.qingyuntop.ai/dashboard//api/usage/token/ \
  -H "Authorization: Bearer $QINGYUN_TOP_API_KEY"