TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Quản lý

Lấy mức sử dụng API key

Trả về chi tiết mức sử dụng có phân trang cho một API key người dùng.

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

Tổng quan

Endpoint này trả về chi tiết mức sử dụng theo API key mà không làm lộ chi tiết thực thi của provider.

Tham số truy vấn

Tham sốKiểuMặc định / giới hạnMô tả
pageintegermặc định 1, tối thiểu 1Số trang bắt đầu từ 1
limitintegermặc định 50, tối thiểu 1, tối đa 100Kích thước mỗi trang
modelstringđộ dài tối đa 100Tên model được yêu cầu
modelVendorstringđộ dài tối đa 100Nhà cung cấp model công khai
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime
startDatestring-Cận dưới bao gồm; chấp nhận RFC3339 có múi giờ hoặc YYYY-MM-DD
endDatestring-Cận trên bao gồm; chấp nhận RFC3339 có múi giờ hoặc YYYY-MM-DD

Nếu truyền đồng thời startDate và endDate, thì startDate phải nhỏ hơn hoặc bằng endDate.

Lưu ý

  • Các trường tiền tệ chỉ hỗ trợ USD.

  • Phản hồi có phân trang.

  • Phản hồi chỉ bao gồm các trường chi phí và báo cáo công khai.

  • Mỗi dòng usage cũng có thể bao gồm billing_transaction_id sau khi request gốc đã được settlement xong. Hãy dùng giá trị này cùng với request_id để đối soát ở cấp request.

  • Metadata routing nội bộ và kênh vật lý sẽ tiếp tục bị ẩn.

Ví dụ

Yêu cầu

cURL
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=chat&startDate=2026-07-01&endDate=2026-07-31" \
  -H "Authorization: Bearer mt-your-management-token"

Yêu cầu / Phản hồi

Trang này cung cấp schema OpenAPI và các ví dụ yêu cầu có thể sao chép. Hãy gửi yêu cầu quản lý từ terminal hoặc ứng dụng khách bằng Management Token; trang này không hỗ trợ gửi trực tiếp.

Ví dụ phản hồi

Phản hồi

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
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5.6-luna",
      "logical_model": "gpt-5.6-luna",
      "model_vendor": "OpenAI",
      "scene": "chat",
      "usage_unit": "per_token",
      "usage_quantity": 1500,
      "usage_quantity_decimal": "1500",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "total_tokens": 1500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "cache_write_tokens_5m": 0,
      "cache_write_tokens_1h": 0,
      "cost": 0.0012,
      "cost_decimal": "0.0012",
      "created_at": "2026-07-08T03:15:00.000Z",
      "requested_policy": null,
      "resolved_tier": null,
      "charged_price_basis": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "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"
      }
    ]
  }
}

Các trường quan trọng

api_keyobject
Tóm tắt khóa API với các trường giống như phản hồi liệt kê, tạo và cập nhật.
itemsarray
Các dòng sử dụng đã phân trang.
paginationobject
Siêu dữ liệu phân trang gồm page, limit, total và totalPages.
summaryobject
Tổng số liệu tổng hợp theo các bộ lọc đã chọn.
breakdownsobject
Phân tích tổng hợp theo các bộ lọc đã chọn.
items[].request_idstring | null
Mã định danh yêu cầu công khai để hỗ trợ và đối soát.
items[].billing_transaction_idstring | null
ID giao dịch thanh toán đã quyết toán khi có.
items[].modelstring
Tên mô hình công khai được yêu cầu.
items[].logical_modelstring
Mô hình công khai logic dùng cho báo cáo.
items[].model_vendorstring | null
Nhà cung cấp mô hình công khai.
items[].scenestring | null
Ngữ cảnh yêu cầu công khai.
items[].usage_unitstring
Đơn vị sử dụng tính phí, chẳng hạn per_token.
items[].usage_quantitynumber
Lượng sử dụng dưới dạng số JSON để hiển thị.
items[].usage_quantity_decimalstring
Lượng sử dụng chính xác dưới dạng chuỗi thập phân.
items[].prompt_tokensnumber
Số token prompt.
items[].completion_tokensnumber
Số token hoàn thành.
items[].total_tokensnumber
Tổng số token.
items[].cache_read_tokensnumber
Số token đọc bộ nhớ đệm.
items[].cache_write_tokensnumber
Tổng số token ghi bộ nhớ đệm.
items[].cache_write_tokens_5mnumber
Số token ghi bộ nhớ đệm 5 phút.
items[].cache_write_tokens_1hnumber
Số token ghi bộ nhớ đệm 1 giờ.
items[].costnumber
Chi phí bằng USD dưới dạng số JSON để hiển thị.
items[].cost_decimalstring
Chi phí chính xác bằng USD dưới dạng chuỗi thập phân.
items[].requested_policystring | null
auto, verified, official, null. Chính sách cung cấp được yêu cầu, nếu đã ghi nhận.
items[].resolved_tierstring | null
verified, official, null. Mức cung cấp đã sử dụng, nếu đã ghi nhận.
items[].charged_price_basisobject | null
Giá áp dụng và lượng tính phí, nếu đã ghi nhận.
items[].created_atstring
Dấu thời gian ISO của dòng sử dụng.
summary.total_requestsnumber
Tổng số yêu cầu.
summary.total_costnumber
Tổng chi phí bằng USD dưới dạng số JSON để hiển thị.
summary.total_cost_decimalstring
Tổng chi phí chính xác bằng USD dưới dạng chuỗi thập phân.
summary.total_prompt_tokensnumber
Tổng số token prompt.
summary.total_completion_tokensnumber
Tổng số token hoàn thành.
summary.total_tokensnumber
Tổng số token.
summary.usage_unit_breakdownarray
Lượng sử dụng được nhóm theo đơn vị sử dụng.
breakdowns.by_modelarray
Phân tích theo mô hình công khai được yêu cầu.
breakdowns.by_logical_modelarray
Phân tích theo mô hình công khai logic.
breakdowns.by_model_vendorarray
Phân tích theo nhà cung cấp mô hình công khai.
breakdowns.by_scenearray
Phân tích theo ngữ cảnh yêu cầu công khai.
breakdowns.daily_costarray
Xu hướng chi phí hằng ngày.

Xác thực

ManagementTokenAuth
AuthorizationBearer <token>

Xác thực bằng Token quản lý. Tạo hoặc quản lý Token quản lý trong Dashboard > API > Management Tokens.

Vị trí: header

Tham số đường dẫn

keyId*string

Tham số truy vấn

page?integer

Số trang bắt đầu từ 1. Mặc định là 1.

Phạm vi1 <= value
mặc định1
limit?integer

Số lượng mục trên mỗi trang. Mặc định là 50 và tối đa là 100.

Phạm vi1 <= value <= 100
mặc định50
model?string

Lọc theo tên model được yêu cầu. Độ dài tối đa 100.

Độ dàilength <= 100
modelVendor?string

Lọc theo nhà cung cấp model công khai. Độ dài tối đa 100.

Độ dàilength <= 100
scene?string

Lọc theo ngữ cảnh yêu cầu công khai.

Giá trị hợp lệ

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

Bộ lọc ngày bao gồm. Chấp nhận RFC3339 có múi giờ (ví dụ: 2026-03-28T00:00:00+08:00) hoặc YYYY-MM-DD.

endDate?string

Bộ lọc ngày bao gồm. Chấp nhận RFC3339 có múi giờ (ví dụ: 2026-03-28T00:00:00+08:00) hoặc YYYY-MM-DD.

Phản hồi

application/json

application/json

application/json

application/json

application/json

Cập Nhật API key

Trước

Lấy dữ liệu thanh toán API Key

Tiếp