Obtener uso de API Key

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-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-mini",
      "claude-3-7-sonnet"
    ],
    "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"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "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"
    }
  ],
  "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-mini",
        "logical_model": "gpt-5-mini",
        "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-mini",
        "logical_model": "gpt-5-mini",
        "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"
      }
    ]
  }
}

Resumen

Este endpoint devuelve el detalle de uso por API Key sin exponer metadata de routing físico.

Parámetros de consulta

Parámetro	Tipo	Valores por defecto / límites	Descripción
`page`	integer	valor por defecto `1`, mínimo `1`	Número de página empezando en 1
`limit`	integer	valor por defecto `50`, mínimo `1`, máximo `100`	Tamaño de página
`model`	string	longitud máxima `100`	Nombre del modelo solicitado
`modelVendor`	string	longitud máxima `100`	Proveedor público del modelo
`scene`	enum	-	`chat`, `image`, `audio`, `video`, `embedding`, `rerank`, `translation`, `music`, `3d`, `realtime`
`startDate`	string	-	Límite inferior inclusivo; acepta RFC3339 con zona horaria o `YYYY-MM-DD`
`endDate`	string	-	Límite superior inclusivo; acepta RFC3339 con zona horaria o `YYYY-MM-DD`

Si startDate y endDate se envían a la vez, startDate debe ser anterior o igual a endDate.

Notas

Los campos monetarios solo admiten USD. Las entradas CNY están retiradas y devuelven 400 currency_retired.
La respuesta está paginada.
La respuesta solo incluye campos públicos de facturación y reporting.
Cada registro de uso también puede incluir billing_transaction_id una vez que la solicitud subyacente haya quedado liquidada. Úsalo junto con request_id para la conciliación a nivel de solicitud.
La metadata de routing interno y de canales físicos permanece oculta de forma intencional.

Ejemplo

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitud / Respuesta

Consulta el panel interactivo de OpenAPI de arriba para ver el esquema exacto y los campos de la respuesta.

Ejemplo de 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-mini",
      "claude-3-7-sonnet"
    ],
    "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"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "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"
    }
  ],
  "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-mini",
        "logical_model": "gpt-5-mini",
        "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-mini",
        "logical_model": "gpt-5-mini",
        "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

object

Resumen de la clave API con los mismos campos que las respuestas de listado, creación y actualización.

array

Filas de uso paginadas.

object

Metadatos de paginación con page, limit, total y totalPages.

object

Totales agregados para los filtros seleccionados.

object

Desgloses agregados para los filtros seleccionados.

string | null

Identificador público de solicitud para soporte y conciliación.

string | null

ID de transacción de facturación liquidada cuando esté disponible.

string

Nombre del modelo público solicitado.

string

Modelo público lógico usado para informes.

string | null

Proveedor del modelo público.

string | null

Escena de solicitud pública.

string

Unidad de uso de facturación, como per_token.

number

Cantidad de uso como número JSON para visualización.

string

Cantidad de uso exacta como cadena decimal.

number

Recuento de tokens de prompt.

number

Recuento de tokens de finalización.

number

Recuento total de tokens.

number

Recuento de tokens leídos de la caché.

number

Recuento total de tokens escritos en la caché.

number

Recuento de tokens de escritura de caché de cinco minutos.

number

Recuento de tokens de escritura de caché de una hora.

number

Coste en USD como número JSON para visualización.

string

Coste exacto en USD como cadena decimal.

string

Marca de tiempo ISO de la fila de uso.

number

Número total de solicitudes.

number

Coste total en USD como número JSON para visualización.

string

Coste total exacto en USD como cadena decimal.

number

Recuento total de tokens de prompt.

number

Recuento total de tokens de finalización.

number

Recuento total de tokens.

array

Cantidad de uso agrupada por unidad de uso.

array

Desglose por modelo público solicitado.

array

Desglose por modelo público lógico.

array

Desglose por proveedor del modelo público.

array

Desglose por escena de solicitud pública.

array

Tendencia diaria del coste.

Base

Texto

Archivos y lotes

Imágenes

Audio y tiempo real

Música

Video y recursos

Worlds

3D

Trabajos asíncronos

Gemini nativo

Administración

Obtener uso de API Key

Resumen

Parámetros de consulta

Notas

Ejemplo

Solicitud / Respuesta

Ejemplo de respuesta

Campos importantes

​Resumen

​Parámetros de consulta

​Notas

​Ejemplo

​Solicitud / Respuesta

​Ejemplo de respuesta

​Campos importantes

Resumen

Parámetros de consulta

Notas

Ejemplo

Solicitud / Respuesta

Ejemplo de respuesta

Campos importantes