Transforma eventos de uso en bruto en cantidades facturables con agregación y filtrado.
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.
Etiqueta de unidad para facturas. Ejemplos: calls, tokens, GB, hours
3
Filtering (Optional)
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 a, distinto de, mayor que, mayor o igual que, menor que, menor o igual que, contiene, no 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.
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.
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:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
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
El medidor agrega - Los eventos se agregan según la configuración del medidor (Count, Sum, Max, Last)
Procesos en segundo plano - Cada minuto, un trabajador obtiene los nuevos eventos desde el último punto de control
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)
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.
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.
