API Key 用量查询接口 — 用 Token 程序化查询用量与到期

你能查到什么

一个 Token，覆盖 API Key 的关键运营指标

到期时间

每个有效 API Key 的精确到期时间，提前规划续费，避免服务中断。

每日与本月用量

今日已用费用、请求数，本月额度已用 / 上限与使用率，一目了然。

Token 自助管理

在 Dashboard 一键生成、重置或撤销令牌；服务端只存哈希，明文仅显示一次。

三步接入

从生成 Token 到跑通查询，只要几分钟

1

在 Dashboard 生成 Token

登录后进入「开放 API」，点击生成，得到一个 qot_ 开头的访问令牌（请妥善保存）。

2

携带 Token 调接口

在请求头加 Authorization: Bearer qot_...，GET /api/v1/openapi/keys 即返回你的用量 JSON。

3

集成到你的工具

把响应接到脚本、监控看板、到期提醒或 CI 流水线，实现自动化运维。

一行命令开始

标准 HTTP + Bearer Token，任何语言都能调

接口返回结构化 JSON，包含每个有效 Key 的名称、到期时间、今日用量与月度额度，便于直接解析。

•只读：仅能查询你自己账户的 API Key，不能创建 / 修改 / 消费余额。
•内置缓存与限流，响应快、对上游友好。

# 请求
curl -H "Authorization: Bearer qot_xxx" \
  https://qcode.cc/api/v1/openapi/keys

示例响应

{
  "ok": true,
  "data": {
    "keys": [{
      "name": "Pro unlimited/day",
      "is_active": true,
      "expires_at_display": "2026/08/22 21:35",
      "current_daily_cost": 42.04,
      "current_requests": 115,
      "monthly_cost_used": 8837.56,
      "monthly_cost_limit": 13000.0
    }],
    "active_api_keys": 1
  }
}

接口一览

全部为只读 GET，鉴权方式统一为 Bearer Token

接口	说明
GET /api/v1/openapi/keys	列出你所有有效 API Key 的到期时间、今日用量、月度额度与使用率。
GET /api/v1/openapi/me	账户级用量汇总：有效 Key 数、今日总消耗。
GET /api/v1/openapi	API 自述：返回端点列表与用法，便于探活。

典型用法

把用量数据接到你已有的工作流

到期提醒

定时检查到期时间，临期自动发邮件 / 企业微信 / Telegram 提醒续费。

用量看板

把每日费用与额度使用率接入 Grafana / 飞书多维表 / 自建面板。

多 Key 巡检

团队持有多把 Key 时，统一拉取所有 Key 的健康与额度状态。

CI / 自动化

在流水线里校验 Key 仍有效、额度充足，再跑昂贵的 AI 任务。

安全设计

令牌为高熵随机串，服务端只存 HMAC 哈希，明文仅生成时显示一次；权限严格只读，无法创建或管理 Key、不触碰余额；内置每分钟 / 每日限流；一旦泄露可在 Dashboard 一键重置，旧令牌立即失效。

常见问题

怎么获取访问令牌？

登录 QCode 后进入 Dashboard 的「开放 API」卡片，点击生成即可。明文令牌仅显示一次，请立即复制保存；遗失可随时重置。

这个令牌安全吗？

安全。它是只读令牌，只能查询你自己账户 API Key 的用量与到期，无法创建 / 修改 Key 或消费余额。服务端只存哈希，泄露后一键重置即失效。

有调用频率限制吗？

有。每个令牌有每分钟与每日调用上限，且查询结果有数秒缓存，足够支撑常规轮询与监控；如需更高配额请联系客服。

用 API 程序化查询你的 API Key 用量与到期