KToken Docs

Appearance

GET /v1/models 与 GET /v1/usage ​

接口用途 ​

  • GET /v1/models：获取当前分组可用模型列表
  • GET /v1/usage：获取当前 API Key 对应的用量、额度或订阅信息

这两个接口都走统一的 /v1 自动平台分流逻辑。

请求路径 ​

text
GET /v1/models
GET /v1/usage

认证方式 ​

  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>

路由别名 ​

无。

适用平台 ​

  • OpenAI 分组
  • Anthropic / Claude 分组
  • Antigravity 模型列表另有 /antigravity/models

上游官方规范 ​

  • models：OpenAI 与 Anthropic 都有类似模型枚举概念，但这里是 KToken 的统一视图
  • usage：这是 KToken 自有扩展能力，不等同于某一家官方接口

GET /v1/models ​

本项目支持说明 ​

  • 会根据当前分组平台返回不同模型集合
  • 可能返回调度后可用模型，而不是上游全量模型
  • 对 OpenAI 分组，代码会回退到默认 OpenAI 模型列表
  • 对 Claude 分组，代码会回退到默认 Claude 模型列表

典型响应 ​

json
{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-20250514",
      "object": "model"
    }
  ]
}

GET /v1/usage ​

本项目支持说明 ​

这是一个 KToken 扩展接口，主要服务于客户端展示额度、订阅和统计信息。

代码中有两种模式：

  • quota_limited
  • unrestricted

并且 /v1/usage 会跳过大部分计费拦截，让已过期或额度不足的 Key 也能查看自身状态。

常用查询参数 ​

参数类型必填说明
start_datestring否起始日期，格式 YYYY-MM-DD，主要用于模型统计
end_datestring否结束日期，格式 YYYY-MM-DD

典型响应字段 ​

字段说明
mode当前是 quota_limited 还是 unrestricted
status当前 API Key 状态
quota配额信息，存在时包含 limit、used、remaining
usagetoday / total 用量摘要
model_stats按模型统计的用量信息

示例响应 ​

json
{
  "mode": "quota_limited",
  "status": "active",
  "quota": {
    "limit": 100,
    "used": 12.5,
    "remaining": 87.5,
    "unit": "USD"
  },
  "usage": {
    "today": {
      "requests": 10,
      "total_tokens": 12345
    },
    "total": {
      "requests": 120,
      "total_tokens": 456789
    }
  }
}

示例请求 ​

bash
curl https://your-domain/api/v1/v1/models \
  -H "Authorization: Bearer sk-xxxx"
bash
curl "https://your-domain/api/v1/v1/usage?start_date=2026-05-01&end_date=2026-05-17" \
  -H "Authorization: Bearer sk-xxxx"

注意事项 ​

  • /v1/usage 是本项目扩展接口，不应假设它与任何单一上游官方格式完全一致
  • models 返回的是“当前平台 / 当前分组下可用”的视图