Administración
Obtener uso de API Key
Devuelve detalles de uso paginados para una API key de usuario.
Descripción general
Devuelve registros de uso paginados para una API key.
Parámetros de consulta
| Parámetro | Tipo | Predeterminado / Límites | Notas |
|---|---|---|---|
page | integer | predeterminado 1, mín 1 | Número de página basado en 1 |
limit | integer | predeterminado 50, mín 1, máx 100 | Tamaño de página |
model | string | longitud máx 100 | Nombre del modelo solicitado |
modelVendor | string | longitud máx 100 | Proveedor del modelo público |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | Límite inferior inclusivo; acepta RFC3339 con zona horaria o YYYY-MM-DD (00:00 UTC) |
endDate | string | - | Límite superior inclusivo; acepta RFC3339 con zona horaria o YYYY-MM-DD. Un valor de solo fecha significa 00:00 UTC al inicio de ese día, por lo que para incluir un día completo, use la fecha siguiente o una hora RFC3339 |
Si tanto startDate como endDate están presentes, startDate debe ser anterior o igual a endDate.
Notas
-
Los campos monetarios están solo en USD.
-
La respuesta está paginada.
-
Los registros liquidados pueden incluir
billing_transaction_id. Guárdelo junto conrequest_idcuando necesite hacer coincidir un cargo con una solicitud. -
Los registros están ordenados por
created_at, los más recientes primero. -
Un error
429con el códigoreport_busysignifica que la cola de informes está llena. Vuelva a intentarlo después de los segundos indicados enRetry-After.
Solicitud
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"Solicitud / Respuesta
Esta página proporciona el esquema OpenAPI y ejemplos de solicitud que se pueden copiar. Envíe solicitudes de gestión desde su terminal o cliente con un Management Token; el envío directo no está disponible en esta página.
Respuesta
{
"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"
}
]
}
}Campos importantes
page, limit, total y totalPages.per_token.auto, verified, official, null. Política de entrega solicitada, cuando se registra.verified, official, null. Nivel de entrega utilizado, cuando se registra.measure.dimensions incluye webSearchCalls o groundedPrompts, y effectiveUnitPrices incluye el precio de cada llamada como webSearch o groundedPrompt.Autorización
ManagementTokenAuth Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.
Ubicación: header
Parámetros de ruta
Parámetros de consulta
Número de página basado en 1. El valor predeterminado es 1.
1 <= value1Tamaño de página. El valor predeterminado es 50 y el máximo es 100.
1 <= value <= 10050Filtrar por nombre de modelo solicitado. Longitud máxima 100.
length <= 100Filtrar por proveedor de modelo público. Longitud máxima 100.
length <= 100Filtrar por escena de solicitud pública.
Valores permitidos
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
Límite inferior, inclusivo. Acepta RFC3339 con zona horaria (por ejemplo, 2026-03-28T00:00:00+08:00) o YYYY-MM-DD, que significa 00:00 UTC.
Límite superior, inclusivo. Acepta RFC3339 con zona horaria (por ejemplo, 2026-03-28T23:59:59+08:00) o YYYY-MM-DD, que significa 00:00 UTC al inicio de ese día. Para incluir un día completo, pase la fecha del día siguiente o una hora RFC3339 al final del día.
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json