관리
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 (00:00 UTC) 형식 허용 |
endDate | string | - | 포함 범위의 종료점; RFC3339 또는 YYYY-MM-DD 형식 허용. 날짜만 입력할 경우 해당 날짜의 00:00 UTC를 의미하므로, 하루 전체를 포함하려면 다음 날짜를 사용하거나 RFC3339 시간을 사용하십시오 |
startDate와 endDate가 모두 제공되는 경우, startDate는 endDate보다 이전이거나 같아야 합니다.
참고 사항
-
통화 관련 필드는 USD 기준입니다.
-
응답은 페이지네이션 처리됩니다.
-
정산된 기록에는
billing_transaction_id가 포함될 수 있습니다. 청구 내역과 요청을 대조해야 할 경우request_id와 함께 저장해 두십시오. -
기록은
created_at을 기준으로 최신순으로 정렬됩니다. -
report_busy코드가 포함된429응답은 보고서 대기열이 가득 찼음을 의미합니다.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공개 요청 장면(scene)으로 필터링.
허용 값
- "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