管理

获取 API 密钥账单

获取一枚 API 密钥的汇总账单。

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

概述

返回总费用、请求数、计费用量,以及按模型、模型厂商、场景和日期分组的费用。

注意事项

  • 金额字段仅支持 USD。

  • 不包含工作区充值和发票记录。

  • 只有日期的 endDate 表示当天 UTC 00:00;要包含整天,请传下一天的日期或 RFC3339 时间。

  • 返回 429 且错误码为 report_busy,表示报表队列已满,按 Retry-After 的秒数后重试。

示例

支持与密钥用量相同的模型、模型厂商、场景和日期筛选;返回汇总,不分页。

请求

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
  -H "Authorization: Bearer mt-your-management-token"

请求 / 响应

本页提供 OpenAPI 结构说明和可复制的请求示例。请在终端或客户端使用 Management Token 发送管理请求;本页不提供直接发送功能。

响应示例

响应

200 OK
{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5.6-luna",
      "claude-sonnet-4-6"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z",
    "delivery_policy": null
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5.6-luna",
        "logical_model": "gpt-5.6-luna",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5.6-luna",
        "logical_model": "gpt-5.6-luna",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

重要字段

api_keyobject
API 密钥摘要,字段与列表、创建、更新响应一致。
summaryobject
按所选筛选条件汇总的总计。
breakdownsobject
按所选筛选条件汇总的细分数据。
summary.total_requestsnumber
请求总数。
summary.total_costnumber
以 JSON 数字返回的 USD 总费用,用于展示。
summary.total_cost_decimalstring
以十进制字符串返回的 USD 精确总费用。
summary.total_prompt_tokensnumber
提示 token 总数。
summary.total_completion_tokensnumber
补全 token 总数。
summary.total_tokensnumber
token 总数。
summary.usage_unit_breakdownarray
按计量单位分组的用量。
breakdowns.by_modelarray
按请求时使用的公开模型拆分。
breakdowns.by_logical_modelarray
按归并后的公开模型拆分。
breakdowns.by_model_vendorarray
按公开模型厂商拆分。
breakdowns.by_scenearray
按公开请求场景拆分。
breakdowns.daily_costarray
每日费用趋势。

授权

ManagementTokenAuth
AuthorizationBearer <token>

管理令牌身份验证。在 Dashboard > API > Management Tokens 中创建或管理管理令牌。

位置: header

路径参数

keyId*string

查询参数

model?string

按请求的模型名称过滤。最大长度 100。

长度length <= 100
modelVendor?string

按公共模型供应商过滤。最大长度 100。

长度length <= 100
scene?string

按公共请求场景过滤。

可选值

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string

下界(包含)。接受带时区的 RFC3339 格式(例如 2026-03-28T00:00:00+08:00)或 YYYY-MM-DD(表示 UTC 时间 00:00)。

endDate?string

上界(包含)。接受带时区的 RFC3339 格式(例如 2026-03-28T23:59:59+08:00)或 YYYY-MM-DD(表示该日 UTC 时间 00:00)。若要包含整天,请传入下一天的日期或该日结束时的 RFC3339 时间。

响应

application/json

application/json

application/json

application/json

application/json

application/json