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.
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ệu | Mặc định / Giới hạn | Ghi chú |
|---|---|---|---|
page | integer | mặc định 1, tối thiểu 1 | Số trang bắt đầu từ 1 |
limit | integer | mặc định 50, tối thiểu 1, tối đa 100 | Kích thước trang |
model | string | độ dài tối đa 100 | Tên model được yêu cầu |
modelVendor | string | độ dài tối đa 100 | Nhà cung cấp model công khai |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | 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) |
endDate | string | - | 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ớirequest_idkhi 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
429với mãreport_busynghĩa là hàng đợi báo cáo đã đầy. Hãy thử lại sau số giây được chỉ định trongRetry-After.
Yêu cầu
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.
Phản hồi
{
"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
page, limit, total, và totalPages.per_token.auto, verified, official, null. Chính sách phân phối được yêu cầu, khi được ghi lại.verified, official, null. Cấp độ phân phối được sử dụng, khi được ghi lại.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.Xác thực
ManagementTokenAuth 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
Tham số truy vấn
Số trang bắt đầu từ 1. Mặc định là 1.
1 <= value1Số lượng mục trên mỗi trang. Mặc định là 50 và tối đa là 100.
1 <= value <= 10050Lọc theo tên model được yêu cầu. Độ dài tối đa 100.
length <= 100Lọc theo nhà cung cấp model công khai. Độ dài tối đa 100.
length <= 100Lọ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"
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.
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