Cobro por uso con Stripe para funciones con IA
Cómo cobrar el uso de IA con Stripe: Meters o Metronome, modelos de precio por tokens y créditos, envío seguro de eventos de uso y límites dentro de tu app.
Read in English →
Para cobrar el uso de IA con Stripe, registras cuánto usa cada cliente (tokens, generaciones, minutos), envías ese uso a Stripe como eventos de medición y asocias un precio medido a la suscripción del cliente, para que Stripe lo cobre al final de cada período. En 2026 Stripe tiene dos productos para esto: la API de Meters, que ahora llama cobro por uso básico, y Metronome, que hoy pertenece a Stripe y es lo que recomienda para integraciones nuevas que necesitan créditos en tiempo real o contratos complejos. En cualquiera de los dos casos, tu app sigue teniendo que contar el uso por su cuenta y aplicar los límites antes de llamar al modelo.
Esta guía te ayuda a elegir entre los dos, definir un modelo de precio, enviar el uso de forma confiable y cerrar los huecos que permiten que un cliente acumule una factura que nadie planeó.
¿Meters o Metronome: cuál usar?
La documentación de Stripe ahora describe a Metronome como su plataforma principal de cobro por uso y el punto de partida recomendado para integraciones nuevas. El cobro por uso básico sobre la API de Meters sigue con soporte completo y se integra mejor con otros productos de Stripe.
| Cobro por uso básico (Meters) | Metronome | |
|---|---|---|
| Pago por uso, cuota fija más excedente | Sí | Sí |
| Créditos | Sí, conciliados al facturar | Sí, descontados en tiempo real |
| Paquetes de créditos prepagos con saldo en vivo | No | Sí |
| Tarifas distintas por modelo o tipo de token en un mismo medidor | No | Sí (precios por dimensión) |
| Compatible con Checkout, Connect y el Dashboard de Stripe | Sí | Limitado o sin soporte |
| Cobro de tokens de LLM con precios de modelos sincronizados | No | Sí, en vista previa pública |
Una regla práctica: si vendes un plan mensual por Checkout con cobro de excedente, Meters es más simple y encaja con el resto de tu configuración de Stripe. Si vendes créditos de IA prepagos que el cliente gasta en tiempo real, o necesitas tarifas distintas por modelo, Metronome está pensado para eso. Su función de cobro de tokens, en vista previa pública, mantiene sincronizados por ti los precios de tokens de los modelos de OpenAI, Anthropic y Google.
El resto de la guía usa Meters, porque es donde empieza la mayoría de las apps pequeñas.
¿Qué modelo de precio le queda a una función con IA?
| Modelo | Cómo cobra | Conviene cuando |
|---|---|---|
| Pago por uso | Por unidad usada, al final del período | El uso varía mucho entre clientes |
| Cuota fija más excedente | La cuota incluye un cupo; lo extra se mide | Quieres ingresos previsibles y un precio justo para el uso intensivo |
| Créditos | El cliente recibe o compra un saldo y el uso lo descuenta | Quieres una sola unidad, el "crédito de IA", para varias funciones |
| Escalonado | El precio por unidad baja con más volumen | Quieres premiar a los clientes grandes |
Elijas el que elijas, pon el precio en una unidad que el cliente entienda. "1.000 créditos" o "100 generaciones" se leen mejor en una factura que los tokens crudos, y te permiten cambiar de modelo más adelante sin rehacer los precios.
¿Cómo se configura con Meters?
- Crea un medidor (meter). En la página Meters del Dashboard o por API. Ponle un nombre de evento, como
tokens_ia, y una forma de agregación: Sum (suma los valores), Count (cuenta los eventos) o Last (toma el último valor). - Crea un precio medido para tu producto que use ese medidor, con el precio por unidad o los escalones que elegiste.
- Agrégalo a la suscripción, solo o junto a tu precio mensual fijo.
- Envía eventos de medición desde tu servidor cada vez que hay uso, o por lotes.
Un evento de medición es una petición corta:
curl https://api.stripe.com/v1/billing/meter_events \
-u "$STRIPE_SECRET_KEY:" \
-d event_name=tokens_ia \
-d "payload[value]=1840" \
-d "payload[stripe_customer_id]=cus_123" \
-d identifier=gen_8f2c1Por defecto el medidor lee el cliente de stripe_customer_id y la cantidad de value; puedes cambiar el nombre de ambas claves al crear el medidor.
¿Cómo envías el uso sin cobrar doble ni perder datos?
La mayoría de los errores aquí están en los eventos, no en los precios.
- Pon siempre un
identifier, como el ID de la generación en tu base de datos. Stripe lo usa para reconocer el mismo evento enviado dos veces, por ejemplo tras un reintento de red. - Cuida la ventana de tiempo. La marca de tiempo del evento debe estar dentro de los últimos 35 días naturales y no más de 5 minutos en el futuro. El uso que llega después de que se finalizó la factura del período no se suma a esa factura ni a la siguiente, así que repórtalo antes del cierre.
- Corrige rápido los errores. Puedes anular un evento con un ajuste de evento de medición, pero solo si lo enviaste en las últimas 24 horas.
- Agrupa cuando hay mucho tráfico. En modo live, el endpoint de eventos de medición admite 1.000 llamadas por segundo por cuenta, con una sola llamada simultánea por cliente y medidor. Sumar el uso por cliente cada minuto suele alcanzar. Para volúmenes mucho mayores, Stripe ofrece los meter event streams de la API v2.
- Cuenta con cierta demora. Stripe procesa los eventos de forma asíncrona, así que los totales de la próxima factura pueden ir atrasados.
¿Por qué tu app igual tiene que aplicar los límites?
Stripe mide el uso para cobrarlo; no frena ninguna petición. Con los créditos del cobro básico, Stripe concilia al facturar y su documentación aclara que el cliente puede pasarse de su saldo durante el período. Por eso:
- Lleva un registro de uso en tu propia base de datos, escrito en el mismo paso que llama al modelo.
- Antes de cada llamada a la IA, revisa cuánto le queda al cliente y bloquea o avisa cuando se acaba.
- Pon un tope duro por cliente y por día, incluso en los planes de pago por uso, para que un error o un script no genere una factura enorme.
Stripe también puede enviar alertas de uso cuando un cliente supera un umbral, una segunda capa útil. Las guías para limitar funciones por plan y controlar el costo de la IA en tu app cubren con más detalle el lado de la app.
¿Cómo le muestras al cliente lo que lleva usado?
La gente acepta facturas por uso cuando puede preverlas. Muestra en tu app el uso actual y el cargo estimado, sacados de tu propio registro, que es en tiempo real mientras que los totales de Stripe pueden ir atrasados. Manda un correo al llegar al 80% y al 100% del cupo incluido. Y pon la unidad y la tarifa en tu página de precios, en palabras simples.
Respuestas rápidas
¿Puedo vender un plan medido con Checkout? Sí, con el cobro por uso básico. Con Metronome, Checkout requiere llamadas a la API y webhooks a medida.
¿Tengo que migrar mi integración de Meters a Metronome? No. Stripe indica que las integraciones existentes con Meters no necesitan migrar.
¿Mando un evento por cada petición a la IA? Puedes, dentro de los límites de llamadas, pero enviar un evento sumado por cliente cada minuto o cada hora es más barato y más fácil de reintentar.
¿Cómo lo pruebo? En un sandbox, suscribe a un cliente de prueba al precio medido, envía eventos y adelanta un reloj de prueba hasta pasar el fin del período para ver la factura. En la guía de suscripciones con Stripe explicamos los relojes de prueba.
¿Tienes una función con IA y no sabes cómo cobrarla?
Lograr que el medidor, tu registro de uso y los límites digan lo mismo es la mayor parte del trabajo. Nuestros servicios de pagos con Stripe y de inteligencia artificial para empresas pueden armar ambos lados. También puedes pasar la revisión gratuita de tu app, leer la documentación de cobro por uso de Stripe o contarnos tu modelo de precios.
