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 medidor mostrando el nombre del evento, tipo de agregación y opciones de filtrado

Recursos de API

Create Meter

Crea medidores programáticamente mediante la API.

List Meters

Recupera todos los medidores de tu cuenta.

Get Meter

Obtén detalles de un medidor específico por ID.

Archive Meter

Archiva un medidor para dejar de rastrear el uso.

Unarchive Meter

Restaura un medidor archivado para reanudar el seguimiento.

Creando un Medidor

1

Basic Information

string
requerido
Un nombre descriptivo para el medidor (por ejemplo, “API Requests”, “Token Usage”).
string
requerido
El nombre exacto del evento que se debe coincidir (distingue entre mayúsculas y minúsculas). Ejemplos: api.call, image.generated.
2

Aggregation

string
requerido
Elige cómo se agregan los eventos:
  • Count: Número total de eventos (llamadas a la API, cargas)
  • Sum: Suma de valores numéricos (tokens, bytes)
  • Max: Valor más alto del período (usuarios máximos)
  • Last: Valor más reciente
string
La clave de metadata que se agregará (obligatoria para Sum, Max y Last). Ejemplos: tokens, bytes, duration_ms.
string
requerido
La etiqueta de unidad para facturas e informes. Ejemplos: calls, tokens, GB, hours.
3

Filtering (Optional)

Interfaz de filtrado de eventos con lógica AND/OR y operadores de comparación
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 disponibles: igual a, no igual a, mayor que, mayor o igual que, menor que, menor o igual que, contiene, no contiene.Activa el filtrado, elige la lógica y, a continuación, añade condiciones con una clave de propiedad, un comparador y un valor.
4

Create

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

Visualizando Analíticas

Panel de análisis del medidor que muestra el resumen del uso, los eventos y los datos de los clientes
El panel del medidor muestra:
  • Overview: Uso total y tendencias de uso a lo largo del tiempo
  • Events: Eventos individuales recibidos y sus metadatos
  • Customers: Totales de uso y cargos por cliente

Facturación en créditos en lugar de moneda

De forma predeterminada, los medidores cobran a los clientes por unidad en dólares (o en la moneda configurada). En su lugar, puedes configurar un medidor para deducir del saldo de crédito de un cliente, de modo que el uso consuma créditos en lugar de generar un cargo monetario.
La deducción basada en créditos requiere un Credit Entitlement asociado al mismo producto. Crea primero el Credit Entitlement y, después, vincúlalo al medidor.

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

Configurar un medidor para deducir créditos

1

Create a Credit Entitlement

Primero, crea un Credit Entitlement en Products → Credits. Define la unidad (por ejemplo, “API Calls”, “Tokens”), la precisión y la configuración del ciclo de vida (caducidad, acumulación y exceso de uso).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 Bill usage in Credits en la configuración del medidor para mostrar la configuración de créditos:
Configuración del medidor con el uso de facturación en la opción de créditos activada

Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.

string
requerido
Selecciona de qué Credit Entitlement deduce este medidor.
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

Free Threshold and Credits

El Free Threshold se aplica a los medidores facturados en dinero, no a los medidores facturados en créditos. Cuando un medidor factura en créditos, cada unidad cuenta para la deducción de créditos.Ejemplo: Con meter-units-per-credit igual a 1, a un cliente que realiza 2,500 llamadas a la API se le deducen 2,500 créditos.

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

Una vez configurado, la canalización de deducción se ejecuta automáticamente:
  1. Llegan los eventos — Tu aplicación envía eventos de uso mediante la Event Ingestion API.
  2. El medidor agrega los datos — Los eventos se agregan según la configuración del medidor (Count, Sum, Max, Last).
  3. El worker en segundo plano procesa los datos — Cada minuto, un worker obtiene los nuevos eventos desde el último punto de control.
  4. Se deducen los créditos — El uso agregado se convierte en créditos mediante la tasa meter_units_per_credit y se deduce mediante el orden FIFO (primero se consumen las concesiones que caducan antes).
  5. Se realiza un seguimiento del exceso de uso — Si el saldo llega a cero, el uso adicional se registra como exceso de uso y se gestiona según el comportamiento configurado (se perdona al restablecerse, se factura en la siguiente factura o se arrastra como déficit). Dodo Payments no bloquea el uso cuando se agota el saldo. Para detener el acceso cuando llegue a cero, comprueba el saldo en tu aplicación.
La deducción de créditos se ejecuta de forma asíncrona (aproximadamente cada 1 minuto). Puede haber un breve retraso entre la ingesta del evento y la deducción del saldo. Diseña tu aplicación para gestionar este retraso y no dependas de comprobaciones del saldo en tiempo real para controlar el acceso en solicitudes individuales.

Múltiples medidores, una reserva de créditos

Puedes vincular varios medidores del mismo producto al mismo Credit Entitlement. Todos los medidores deducen de un único saldo compartido. Ejemplo: Una plataforma de IA con dos medidores:
  • text.generation — 1 crédito por cada 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 (distingue entre mayúsculas y minúsculas)
  • Comprueba que los filtros del medidor no estén excluyendo eventos
  • Verifica que los ID de cliente existan en tu cuenta
  • Desactiva temporalmente los filtros para realizar una prueba
  • Verifica que Over Property coincida exactamente con la clave de metadata
  • Usa números, no strings: tokens: 150, no tokens: "150"
  • Incluye las propiedades obligatorias en todos los eventos
  • Respeta exactamente las mayúsculas y minúsculas
  • Usa los operadores correctos para el tipo de datos
  • Asegúrate de que los eventos incluyan las propiedades filtradas
  • Comprueba la pestaña Events para contar los eventos recibidos reales
  • Verifica el tipo de agregación (Count frente a Sum)
  • Asegúrate de que los valores sean numéricos para Sum y 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.
Última modificación el 26 de septiembre de 2026