TokenLab
取得 API Key
文件API 參考整合

管理

取得 API Key 帳單

返回某個使用者 API Key 的聚合帳單明細。

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

概覽

這個端點返回所選 API Key 的消費帳單聚合結果，包括總費用、總請求數、按計費單位統計的用量，以及 by_model、by_logical_model、by_model_vendor、by_scene 四類拆分與每日費用趨勢。

注意事項

  • 金額欄位僅支援 USD。

  • 儲值、發票等組織級財務流水不會包含在這裡。

範例

支援與金鑰用量相同的模型、模型廠商、場景和日期篩選；回傳彙總，不分頁。

請求

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31" \
  -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-3-7-sonnet"
    ],
    "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 Key 摘要，欄位與列出、建立和更新回應相同。
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
endDate?string

回應

application/json

application/json

application/json

application/json

application/json

取得 API Key 用量

上一頁