Quản lý
Lấy thông tin thanh toán API Key
Trả về bảng phân tích thanh toán tổng hợp cho một API key của người dùng.
Tổng quan
Trả về tổng chi tiêu, số lượng yêu cầu, mức sử dụng có thể tính phí và chi phí được nhóm theo model, nhà cung cấp model, scene và ngày.
Lưu ý
-
Các trường tiền tệ chỉ tính bằng USD.
-
Không bao gồm các khoản nạp tiền vào Workspace và hóa đơn.
-
endDatechỉ bao gồm ngày có nghĩa là 00:00 UTC vào đầu ngày đó. Để bao gồm trọn vẹn một ngày, hãy sử dụng ngày tiếp theo hoặc thời gian theo định dạng RFC3339. -
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.
Ví dụ
Hỗ trợ các bộ lọc về model, nhà cung cấp model, scene và ngày tương tự như sử dụng API key. Trả về tổng số mà không phân trang.
Yêu cầu
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"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
},
"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
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
Lọ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