管理
取得 API Key 帳單
傳回使用者 API key 的彙總帳單明細。
概覽
傳回依模型、模型製造商、場景和日期分組的總支出、請求次數、可計費使用量及成本。
注意事項
-
金額欄位僅以 USD 為單位。
-
不包含工作區儲值與發票。
-
僅包含日期的
endDate代表該日期的 00:00 UTC。若要包含完整的一天,請使用下一個日期或 RFC3339 時間格式。 -
收到代碼為
report_busy的429錯誤,表示報告佇列已滿。請在Retry-After指定的秒數後重試。
範例
支援與 API key 使用量 相同的模型、模型供應商、場景和日期篩選器。傳回不含分頁的總計。
請求
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"請求 / 回應
本頁面提供 OpenAPI 架構與可複製的請求範例。請使用 Management Token 從您的終端機或客戶端發送管理請求;本頁面不提供直接發送功能。
回應
{
"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"
}
]
}
}重要欄位
授權
ManagementTokenAuth 管理權杖驗證。請在 Dashboard > API > Management Tokens 建立或管理管理權杖。
位置: header
路徑參數
查詢參數
按請求的模型名稱篩選。最大長度 100。
length <= 100按公開模型供應商篩選。最大長度 100。
length <= 100按公開請求場景篩選。
可選值
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
下界(包含)。接受 RFC3339 格式並帶有時區(例如 2026-03-28T00:00:00+08:00)或 YYYY-MM-DD(代表 UTC 時間 00:00)。
上界(包含)。接受 RFC3339 格式並帶有時區(例如 2026-03-28T23:59:59+08:00)或 YYYY-MM-DD(代表該日 UTC 時間 00:00)。若要包含整天,請傳遞隔天的日期或該日結束時的 RFC3339 時間。
回應
application/json
application/json
application/json
application/json
application/json
application/json