TokenLab

Quản lý

Lấy thông tin sử dụng API Key

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

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

Tổng quan

Trả về các bản ghi sử dụng được phân trang cho một API key.

Tham số truy vấn

Tham sốKiểu dữ liệuMặc định / Giới hạnGhi chú
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 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, systemone
startDatestring-Cận dưới bao gồm; chấp nhận RFC3339 kèm múi giờ hoặc YYYY-MM-DD (00:00 UTC)
endDatestring-Cận trên bao gồm; chấp nhận RFC3339 kèm múi giờ hoặc YYYY-MM-DD. Giá trị chỉ ngày có nghĩa là 00:00 UTC vào đầu ngày đó, vì vậy để bao gồm cả ngày, hãy sử dụng ngày tiếp theo hoặc thời gian RFC3339

Nếu cả startDate và endDate đều được cung cấp, startDate phải sớm hơn hoặc bằng endDate.

Ghi chú

  • Các trường tiền tệ chỉ tính bằng USD.

  • Phản hồi được phân trang.

  • Các bản ghi đã quyết toán có thể bao gồm billing_transaction_id. Hãy lưu lại cùng với request_id khi bạn cần đối soát phí với một yêu cầu.

  • Các bản ghi được sắp xếp theo created_at, mới nhất trước.

  • Mã lỗi 429 với mã report_busy nghĩa là hàng đợi báo cáo đã đầy. Hãy thử lại sau số giây được chỉ định trong Retry-After.

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-31T23:59:59Z" \
  -H "Authorization: Bearer mt-your-management-token"

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

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

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-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
  },
  "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 API key sử dụng các trường tương tự như phản hồi liệt kê/tạo/cập nhật.
itemsarray
Các hàng dữ liệu sử dụng được phân trang.
paginationobject
Siêu dữ liệu phân trang với page, limit, total, và totalPages.
summaryobject
Tổng hợp các giá trị cho các bộ lọc đã chọn.
breakdownsobject
Phân tích chi tiết cho các bộ lọc đã chọn.
items[].request_idstring | null
Đị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ó sẵn.
items[].modelstring
Tên model công khai được yêu cầu.
items[].logical_modelstring
Model công khai logic được sử dụng để báo cáo.
items[].model_vendorstring | null
Nhà cung cấp model công khai.
items[].scenestring | null
Ngữ cảnh yêu cầu công khai.
items[].usage_unitstring
Đơn vị sử dụng thanh toán, ví dụ: per_token.
items[].usage_quantitynumber
Số lượng sử dụng dưới dạng số JSON để hiển thị.
items[].usage_quantity_decimalstring
Số lượng sử dụng chính xác dưới dạng chuỗi thập phân.
items[].prompt_tokensnumber
Số lượng token đầu vào (prompt).
items[].completion_tokensnumber
Số lượng token đầu ra (completion).
items[].total_tokensnumber
Tổng số lượng token.
items[].cache_read_tokensnumber
Số lượng token đọc từ bộ nhớ đệm.
items[].cache_write_tokensnumber
Tổng số lượng token ghi vào bộ nhớ đệm.
items[].cache_write_tokens_5mnumber
Số lượng token ghi vào bộ nhớ đệm trong 5 phút.
items[].cache_write_tokens_1hnumber
Số lượng token ghi vào bộ nhớ đệm trong 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 phân phối được yêu cầu, khi được ghi lại.
items[].resolved_tierstring | null
verified, official, null. Cấp độ phân phối được sử dụng, khi được ghi lại.
items[].charged_price_basisobject | null
Giá áp dụng và số lượng tính phí, khi được ghi lại. Đối với yêu cầu có phí công cụ, measure.dimensions bao gồm webSearchCalls hoặc groundedPrompts, và effectiveUnitPrices bao gồm giá của mỗi cuộc gọi dưới dạng webSearch hoặc groundedPrompt.
items[].created_atstring
Dấu thời gian ISO của hàng dữ liệu sử dụng.
summary.total_requestsnumber
Tổng số lượng 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 đầu vào.
summary.total_completion_tokensnumber
Tổng số token đầu ra.
summary.total_tokensnumber
Tổng số token.
summary.usage_unit_breakdownarray
Số lượng sử dụng được nhóm theo đơn vị sử dụng.
breakdowns.by_modelarray
Phân tích theo model công khai được yêu cầu.
breakdowns.by_logical_modelarray
Phân tích theo model công khai logic.
breakdowns.by_model_vendorarray
Phân tích theo nhà cung cấp model 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

Giới hạn dưới, bao gồm cả giá trị này. Chấp nhận định dạng RFC3339 kèm múi giờ (ví dụ 2026-03-28T00:00:00+08:00) hoặc YYYY-MM-DD, nghĩa là 00:00 UTC.

endDate?string

Giới hạn trên, bao gồm cả giá trị này. Chấp nhận định dạng RFC3339 kèm múi giờ (ví dụ 2026-03-28T23:59:59+08:00) hoặc YYYY-MM-DD, nghĩa là 00:00 UTC vào đầu ngày đó. Để bao gồm cả ngày, hãy truyền ngày tiếp theo hoặc thời gian RFC3339 vào cuối ngày.

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json