TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Administración

Obtener facturación de clave API

Devuelve desgloses agregados de facturación para una clave API de usuario.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

Resumen

Este endpoint devuelve agregados de facturación basados en consumo para la clave API seleccionada, incluidos el coste total, las solicitudes totales, el uso por unidad de facturación, los desgloses by_model, by_logical_model, by_model_vendor y by_scene, y una tendencia diaria del coste.

Notas

  • Los campos monetarios solo admiten USD.

  • Las recargas, facturas y otros registros financieros a nivel de organización quedan excluidos.

Ejemplo

Admite los mismos filtros de modelo, proveedor, escena y fecha que el uso de la clave API. Devuelve totales sin paginación.

Solicitud

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitud / Respuesta

Esta página ofrece el esquema OpenAPI y ejemplos de solicitudes que puedes copiar. Envía las solicitudes de gestión desde tu terminal o cliente con un Management Token; esta página no permite enviarlas directamente.

Ejemplo de respuesta

Respuesta

200 OK
{
  "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-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",
    "delivery_policy": null
  },
  "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

api_keyobject
Resumen de la clave API con los mismos campos que las respuestas de listado, creación y actualización.
summaryobject
Totales agregados para los filtros seleccionados.
breakdownsobject
Desgloses agregados para los filtros seleccionados.
summary.total_requestsnumber
Número total de solicitudes.
summary.total_costnumber
Coste total en USD como número JSON para visualización.
summary.total_cost_decimalstring
Coste total exacto en USD como cadena decimal.
summary.total_prompt_tokensnumber
Recuento total de tokens de prompt.
summary.total_completion_tokensnumber
Recuento total de tokens de finalización.
summary.total_tokensnumber
Recuento total de tokens.
summary.usage_unit_breakdownarray
Cantidad de uso agrupada por unidad de uso.
breakdowns.by_modelarray
Desglose por modelo público solicitado.
breakdowns.by_logical_modelarray
Desglose por modelo público lógico.
breakdowns.by_model_vendorarray
Desglose por proveedor del modelo público.
breakdowns.by_scenearray
Desglose por escena de solicitud pública.
breakdowns.daily_costarray
Tendencia diaria del coste.

Autorización

ManagementTokenAuth
AuthorizationBearer <token>

Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.

Ubicación: header

Parámetros de ruta

keyId*string

Parámetros de consulta

model?string

Filtrar por nombre de modelo solicitado. Longitud máxima 100.

Longitudlength <= 100
modelVendor?string

Filtrar por proveedor de modelo público. Longitud máxima 100.

Longitudlength <= 100
scene?string

Filtrar por escena de solicitud pública.

Valores permitidos

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string
endDate?string

Respuesta

application/json

application/json

application/json

application/json

application/json

Obtener uso de API Key

Anterior