Saltar al contenido principal
Los medidores convierten eventos sin procesar en cantidades facturables. Filtran eventos y aplican funciones de agregación (Count, Sum, Max, Last) para calcular el uso por cliente.
Interfaz de creación de medidores que muestra el nombre del evento, el tipo de agregación y las opciones de filtrado

​
Recursos de API

​
Creando un Medidor

1

Basic Information

​
Meter Name
string
requerido
Nombre descriptivo (p. ej., “API Requests”, “Token Usage”)
​
Event Name
string
requerido
Nombre exacto del evento que debe coincidir (sensible a mayúsculas). Ejemplos: api.call, image.generated
2

Aggregation

​
Aggregation Type
string
requerido
Elige cómo se agregan los eventos:
  • Count: Número total de eventos (llamadas a la API, cargas)
  • Sum: Suma valores numéricos (tokens, bytes)
  • Max: Valor más alto en el periodo (usuarios máximos)
  • Last: Valor más reciente
​
Over Property
string
Clave de metadatos para agregar (obligatoria para todos los tipos excepto Count). Ejemplos: tokens, bytes, duration_ms
​
Measurement Unit
string
requerido
Etiqueta de unidad para facturas. Ejemplos: calls, tokens, GB, hours
3

Filtering (Optional)

Filtrado de eventos
Agrega condiciones para filtrar qué eventos se cuentan:
  • Lógica AND: Todas las condiciones deben coincidir
  • Lógica OR: Cualquier condición puede coincidir
Comparadores: igual, no igual, mayor que, menor que, contieneActiva el filtrado, elige la lógica, añade condiciones con clave de propiedad, comparador y valor.
4

Create

Revisa la configuración y haz clic en Create Meter.

​
Visualizando Analíticas

Analíticas del medidor
Tu panel de medidores muestra:
  • Resumen: Uso total y gráfico de uso
  • Eventos: Eventos individuales recibidos
  • Clientes: Uso y cargos por cliente

​
Facturación en créditos en lugar de moneda

Por defecto, los medidores cobran a los clientes por unidad en dólares (o la moneda configurada). En cambio, puedes configurar un medidor para deducir de un saldo de créditos; de ese modo, el uso consume créditos en lugar de generar un cargo monetario.
La deducción basada en créditos requiere una Asignación de créditos adjunta al mismo producto. Crea primero tu crédito y luego vincúlalo al medidor.

​
Cuándo usar la deducción basada en créditos

EscenarioEstándar (moneda)Basado en créditos
Precios simples por unidad ($0.01/llamada)✅ Mejor opciónSobrecarga innecesaria
Paquetes de créditos prepago (comprar 10K tokens, usar con el tiempo)❌ No se puede expresar✅ Mejor opción
Uso incluido con suscripciones (plan Pro incluye 100K llamadas)Posible mediante umbral gratuito✅ Mejor - los créditos se acumulan, expiran y se muestran en el portal
Productos con múltiples medidores que comparten una reserva de créditos❌ Cada medidor factura por separado✅ Todos los medidores deducen de un mismo saldo

​
Configurar un medidor para deducir créditos

1

Create a Credit Entitlement

Primero, crea un crédito en Productos → Créditos. Define la unidad (por ejemplo, “Llamadas a la API”, “Tokens”), la precisión y los ajustes del ciclo de vida (caducidad, acumulación, excedente).Consulta la guía de facturación basada en créditos para obtener instrucciones detalladas.
2

Create or Edit a Usage-Based Product

Ve a tu producto basado en uso y abre la sección de configuración del Medidor.
3

Add a Meter

Haz clic en el botón + para adjuntar un medidor. Configura el nombre del evento, el tipo de agregación y la unidad de medida como de costumbre.
4

Enable 'Bill Usage in Credits'

Activa Facturar uso en Créditos en la configuración del medidor. Esto muestra los ajustes de crédito:
Configuración del medidor con la opción Facturar uso en Créditos activada
​
Credit Entitlement
string
requerido
Selecciona de qué asignación de créditos debe deducir este medidor.
​
Meter units per credit
number
requerido
El número de unidades de uso necesarias para deducir 1 crédito. Por ejemplo:
  • 1 = cada evento del medidor deduce 1 crédito
  • 100 = 100 eventos del medidor deducen 1 crédito
  • 1000 = 1.000 llamadas a la API consumen 1 crédito
5

Set the Free Threshold

El Umbral gratuito sigue aplicándose: los eventos por debajo de ese umbral no deducen créditos.Ejemplo: Con un umbral gratuito de 1.000 y unidades del medidor por crédito de 1:
  • El cliente usa 2.500 llamadas a la API
  • Las primeras 1.000 son gratis
  • Las 1.500 restantes deducen 1.500 créditos de su saldo

​
Cómo funciona la deducción de créditos

Una vez configurado, la canalización de deducción se ejecuta automáticamente:
  1. Llegan eventos - Tu aplicación envía eventos de uso a través de la API de ingestión de eventos
  2. El medidor agrega - Los eventos se agregan según la configuración del medidor (Count, Sum, Max, Last)
  3. Procesos en segundo plano - Cada minuto, un trabajador obtiene los nuevos eventos desde el último punto de control
  4. Se deducen créditos - El uso agregado se convierte en créditos usando la tarifa meter_units_per_credit y se deduce mediante orden FIFO (primero se consumen los créditos más antiguos)
  5. Se registra el exceso - Si el saldo llega a cero y el exceso está habilitado, el uso continúa y el exceso se gestiona según el comportamiento configurado (perdonado al restablecer, facturado en la siguiente factura o trasladado como déficit)
La deducción de créditos se ejecuta de forma asíncrona (cada ~1 minuto). Puede haber una breve demora entre la ingestión del evento y la deducción del saldo. Diseña tu aplicación para manejar esta demora: no dependas de verificaciones de saldo en tiempo real para el control de acceso de solicitudes individuales.

​
Múltiples medidores, una reserva de créditos

Puedes vincular múltiples medidores en el mismo producto a la misma asignación de créditos. Todos los medidores deducen de un saldo compartido. Ejemplo: Una plataforma de IA con dos medidores:
  • text.generation - 1 crédito por 1.000 tokens
  • image.generation - 10 créditos por imagen
Ambos deducen del mismo fondo de “Créditos de IA”. El cliente ve un saldo unificado en su portal.
Usa diferentes tarifas meter_units_per_credit entre medidores para expresar costos relativos. Las operaciones costosas (generación de imágenes) requieren menos unidades del medidor por crédito que las operaciones baratas (completado de texto).

List Customer Ledger

Consulta el historial completo de deducción de créditos de un cliente.

Get Customer Balance

Consulta el saldo de créditos actual de un cliente mediante la API.

​
Solución de problemas

  • El nombre del evento debe coincidir exactamente (sensible a mayúsculas)
  • Verifica que los filtros del medidor no estén excluyendo eventos
  • Comprueba que existan los ID de cliente
  • Desactiva temporalmente los filtros para hacer pruebas
  • Verifica que la propiedad Over coincida exactamente con la clave de metadatos
  • Usa números, no cadenas: tokens: 150 no "150"
  • Incluye las propiedades requeridas en todos los eventos
  • Coincide exactamente con mayúsculas y minúsculas
  • Usa los operadores correctos para el tipo de datos
  • Asegura que los eventos incluyan las propiedades filtradas
  • Revisa la pestaña Eventos para contar los eventos realmente recibidos
  • Verifica el tipo de agregación (Count vs Sum)
  • Asegura que los valores sean numéricos para Sum/Max

​
Próximos pasos

Send Events

Comienza a enviar eventos de uso desde tu aplicación a tus medidores.

View Blueprints

Utiliza configuraciones de medidor ya preparadas para casos de uso comunes.