管理
获取 API 密钥用量
分页获取一枚 API 密钥的用量明细。
概述
分页返回单个 API 密钥的用量记录。
查询参数
| 参数 | 类型 | 默认值 / 限制 | 说明 |
|---|---|---|---|
page | integer | 默认 1,最小 1 | 从 1 开始的页码 |
limit | integer | 默认 50,最小 1,最大 100 | 每页条数 |
model | string | 最大长度 100 | 请求时使用的模型名 |
modelVendor | string | 最大长度 100 | 公开模型厂商 |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | 起始时间(含),接受带时区的 RFC3339 或 YYYY-MM-DD(UTC 00:00) |
endDate | string | - | 结束时间(含),接受带时区的 RFC3339 或 YYYY-MM-DD。只有日期时表示当天 UTC 00:00;要包含整天,请传下一天的日期或 RFC3339 时间 |
如果同时提供 startDate 和 endDate,则 startDate 必须早于或等于 endDate。
说明
-
金额字段仅支持 USD。
-
响应是分页的。
-
完成结算的记录会带有
billing_transaction_id,需要将扣费与请求对应时,请与request_id一起保存。 -
记录按
created_at倒序排列。 -
返回
429且错误码为report_busy,表示报表队列已满,按Retry-After的秒数后重试。
请求
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"请求 / 响应
本页提供 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
},
"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"
}
]
}
}重要字段
page、limit、total 和 totalPages。per_token。auto、verified、official、null。记录时返回请求的交付策略。verified、official、null。记录时返回实际使用的交付档位。measure.dimensions 包含 webSearchCalls 或 groundedPrompts,effectiveUnitPrices 包含每次调用的单价 webSearch 或 groundedPrompt。授权
ManagementTokenAuth 管理令牌身份验证。在 Dashboard > API > Management Tokens 中创建或管理管理令牌。
位置: header
路径参数
查询参数
基于 1 的页码。默认为 1。
1 <= value1每页大小。默认为 50,最大为 100。
1 <= value <= 10050按请求的模型名称过滤。最大长度 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