GET /openapi/memorylake/admin/v1/usage
usage:view_all 时数据覆盖整个团队；仅持有 usage:view_self 的调用方获得自己的用量（包括其 API Key），并由 scope 指明是哪一种。bucket_width=1d 会额外返回按天的序列；group_by=member 会额外返回按成员的明细，且需要 usage:view_all。
所需权限：
usage:view_all（全团队）或 usage:view_self（仅本人）- 传入
group_by=member时：usage:view_all
查询参数
string
要包含的第一天，YYYY-MM-DD，按
period.timezone 所示时区计算。默认为 end_date 前六天。string
要包含的最后一天，YYYY-MM-DD，按
period.timezone 所示时区计算。默认为今天。string
设为
1d 可同时获取 buckets：该周期内按天的时间序列。array
可重复。
by_model 始终针对该周期返回；member 会额外返回 by_member（需要 usage:view_all）。当 bucket_width=1d 时，每个桶也携带此处列出的明细。curl -X GET 'https://app.memorylake.cn/openapi/memorylake/admin/v1/usage' \
-H 'Authorization: Bearer sk_xxxxxx'
响应
object
Show Usage 对象
Show Usage 对象
array
object
object
string
数据覆盖的消耗范围：
team（调用方持有 usage:view_all）或 self（仅持有 usage:view_self——调用方本人的用量，包括其 API Key；2026-05-21 之前的 API Key 用量记录在 Key 本身名下，不计入 self 数据）object
array
仅当
bucket_width=1d 时返回：计费周期内每天一条，按时间从早到晚排列，无用量的日期以零计入。每个桶携带 group_by 中指定的明细。Show Usage Bucket 对象
Show Usage Bucket 对象
integer
生成的补全 tokens
string
日期，格式为
YYYY-MM-DD，按 period.timezone 计算integer
时间桶结束时间，Unix 秒级时间戳（不含）
integer
消耗的 Prompt tokens
integer
请求数
integer
时间桶开始时间，Unix 秒级时间戳（含）
integer
从余额中扣除的消耗，单位为 tokens
array
array
仅当
group_by=member 时返回（无人产生用量时为空数组）：按成员的明细，用量最大者在前。包含此后已离开团队的人员，因此请求数和 token 数之和与 totals 一致；used_tokens 按条目向下取整，因此其总和可能比 totals.used_tokens 少，每个条目差额不足一个 token{
"success": true,
"message": "Operation completed successfully",
"data": {
"by_model": [
{
"completion_tokens": 1200000,
"model": "example",
"prompt_tokens": 1200000,
"requests": 1,
"used_tokens": 1200000
}
],
"period": {
"end_date": "example",
"start_date": "example",
"timezone": "example"
},
"quota": {
"available_tokens": 1200000,
"unlimited": false
},
"scope": "team",
"totals": {
"completion_tokens": 1200000,
"prompt_tokens": 1200000,
"requests": 1,
"used_tokens": 1200000
},
"buckets": [
{
"completion_tokens": 1200000,
"date": "example",
"end_time": 1760000000,
"prompt_tokens": 1200000,
"requests": 1,
"start_time": 1760000000,
"used_tokens": 1200000,
"by_member": [
{
"completion_tokens": 1200000,
"display_name": "Alice",
"principal_id": "7eccf77fb75500eaacca3ce819c381f0",
"prompt_tokens": 1200000,
"requests": 1,
"used_tokens": 1200000
}
],
"by_model": [
{
"completion_tokens": 1200000,
"model": "example",
"prompt_tokens": 1200000,
"requests": 1,
"used_tokens": 1200000
}
]
}
],
"by_member": [
{
"completion_tokens": 1200000,
"display_name": "Alice",
"principal_id": "7eccf77fb75500eaacca3ce819c381f0",
"prompt_tokens": 1200000,
"requests": 1,
"used_tokens": 1200000
}
]
}
}