Skip to main content
Deja que Sentra escriba tu código de integración.
Usa nuestro asistente de IA en VS Code, Cursor o Windsurf para generar código de SDK/API, código de integración de LLM Blueprint, webhooks y mucho más; solo tienes que describir lo que quieres.
Prueba Sentra: integración con tecnología de IA →
En este tutorial, crearás una aplicación de chat con IA con facturación automática basada en el uso. Crearemos todo desde cero: el medidor de facturación, la configuración del producto y el código de la aplicación que permite mantener conversaciones y realiza un seguimiento del uso de tokens en tiempo real.
Este tutorial proporciona una aplicación completa y funcional, con backend y frontend. La aplicación de chat utiliza la IA Gemini de Google y realiza un seguimiento automático del uso de tokens sin necesidad de ningún recuento manual.
Al finalizar este tutorial, tendrás una aplicación de chat funcional que:
  • Permite mantener conversaciones con IA usando Google Gemini (AI SDK)
  • Realiza un seguimiento automático del uso de tokens (sin código manual)
  • Cobra a los clientes según el consumo real de tokens
  • Incluye una atractiva interfaz de chat
Demostración de chat con IA

Lo que vamos a crear

Comencemos por comprender nuestro servicio de chat con IA:
  • Servicio: chat con tecnología de IA usando Google Gemini (AI SDK)
  • Modelo de precios: pago por token ($0.01 por cada 1,000 tokens)
  • Nivel gratuito: 10,000 tokens gratuitos por cliente al mes
  • Funciones: historial de conversaciones y seguimiento automático de tokens
Antes de comenzar, asegúrate de tener:

Paso 1: Crea tu medidor de uso

Comenzaremos creando un medidor en tu panel de control de Dodo Payments que realizará un seguimiento del uso de tokens de IA.
Lo que vamos a crear: un medidor llamado “AI Token Usage Meter” que suma todos los tokens consumidos en las conversaciones de chat.
1

Open the Meters section

  1. Inicia sesión en tu panel de control de Dodo Payments
  2. Haz clic en Products en la barra lateral izquierda
  3. Haz clic en Meters
  4. Haz clic en el botón Create Meter
Crear medidor
Deberías ver un formulario en el que configuraremos el seguimiento de tokens.
2

Fill in the basic meter information

Ahora introduciremos los detalles específicos de nuestro servicio de chat con IA:Nombre del medidorAI Token Usage MeterDescripciónTracks token consumption from AI chat conversations using AI SDKNombre del eventoai_chat_usage
El nombre del evento ai_chat_usage debe coincidir exactamente con lo que enviaremos más adelante desde el código de nuestra aplicación. ¡Los nombres de los eventos distinguen entre mayúsculas y minúsculas!
3

Configure how we count tokens

Configura la agregación (cómo cuenta el medidor nuestros eventos):Tipo de agregación: selecciona Sum en el menú desplegableAgregado sobre: escribe → totalTokensUnidad de medición: escribe → tokens
Usamos “Sum” porque queremos sumar todos los tokens consumidos en varios mensajes de chat. El SDK envía automáticamente totalTokens en cada evento.
4

Create your meter

  1. Comprueba que todos los ajustes coincidan con los valores anteriores
  2. Haz clic en Create Meter
Configuración del medidor
¡Medidor creado! Tu “AI Token Usage Meter” ya está listo para comenzar a contar tokens. A continuación, lo conectaremos a un producto de facturación.

Paso 2: Obtén tus claves de API

Antes de crear la aplicación, reunamos las claves de API que necesitaremos.
1

Get Dodo Payments API Key

  1. En el panel de control de Dodo Payments, ve a DevelopersAPI Keys
  2. Haz clic en Create API Key
  3. Copia la clave de API; tendrá un aspecto similar a test_abc123...
Guarda esta clave de API; más adelante la añadiremos a nuestro archivo .env.
2

Get Google AI API Key

  1. Visita aistudio.google.com
  2. Haz clic en Get API Key
  3. Crea una clave de API nueva o usa una existente
  4. Copia la clave
Guarda esta clave en un lugar seguro; también la añadiremos a nuestro archivo .env.

Paso 3: Crea tu producto de facturación

Ahora debemos crear un producto que defina nuestros precios ($0.01 por cada 1,000 tokens con 10,000 tokens gratuitos). Esto conecta nuestro medidor con la facturación real.
Lo que vamos a crear: un producto llamado “AI Chat Service” que cobra según el consumo de tokens y ofrece un generoso nivel gratuito.
1

Navigate to Products

  1. En el panel de control de Dodo Payments, haz clic en Products en la barra lateral izquierda
  2. Haz clic en Create Product
  3. Selecciona Usage-Based como tipo de producto
Esto indica a Dodo Payments que la facturación se basará en el uso del medidor, no en una suscripción fija.
2

Enter product details

Completa los datos obligatorios:Nombre del producto: → AI Chat ServiceDescripción: → AI-powered chat service with automatic token-based billingImagen del producto: sube una imagen relevante
Estos datos aparecerán en las facturas de los clientes, así que deben ser claros y profesionales.
3

Connect your meter

Antes de conectar el medidor, asegúrate de haber seleccionado Usage Based Billing como tipo de precio del producto.Además, establece el Fixed Price en 0 para asegurarte de que los clientes solo paguen según su uso, sin ninguna tarifa base.Ahora, vincula el medidor que acabas de crear:
  1. Desplázate hasta la sección Associated Meter
  2. Haz clic en Add Meters
  3. En el menú desplegable, selecciona “AI Token Usage Meter” (el que creaste anteriormente)
  4. Confirma que aparezca en la configuración de tu producto
Tu medidor ya está conectado correctamente a este producto.
4

Set your pricing

Aquí definimos nuestro modelo de negocio:Precio por unidad: introduce → 0.00001 (esto equivale a 0.01porcada1,000tokenso0.01 por cada 1,000 tokens o 0.00001 por token)Umbral gratuito: introduce → 10000 (los clientes reciben 10,000 tokens gratuitos al mes)
Precios del producto
Cómo funciona la facturación: si un cliente utiliza 25,000 tokens en un mes, se le cobrará por 15,000 tokens (25,000 - 10,000 gratuitos) = 15,000 × 0.00001=0.00001 = 0.15
5

Save your product

  1. Revisa todos los ajustes:
    • Nombre: AI Chat Service
    • Medidor: AI Token Usage Meter
    • Precio: $0.01 por cada 1,000 tokens
    • Nivel gratuito: 10,000 tokens
  2. Haz clic en Save Changes
¡Producto creado! Tu facturación ya está configurada. A los clientes se les cobrará automáticamente según el uso de tokens.

Paso 4: Realiza una compra de prueba

Antes de comenzar a crear la aplicación, creemos un cliente de prueba realizando una compra.
1

Get your payment link

  1. En el panel de control de Dodo Payments, ve a Products
  2. Busca el producto “AI Chat Service”
  3. Haz clic en el botón Share junto al producto
  4. Copia el enlace de pago que aparece
2

Complete a test purchase

  1. Abre el enlace de pago en una pestaña nueva del navegador
  2. Introduce los datos de pago de prueba y completa la compra
Después de realizar el pago correctamente, tendrás un ID de cliente que utilizaremos en el código de nuestra aplicación.
3

Find your customer ID

  1. Vuelve al panel de control de Dodo Payments
  2. Ve a Sales -> Customers en la barra lateral izquierda
  3. Busca el cliente que acabas de crear (con el correo electrónico de prueba)
  4. Copia el ID de cliente; tendrá un aspecto similar a cus_123
Guarda este ID de cliente; lo utilizaremos al probar nuestra aplicación de chat.

Paso 5: Crea la aplicación de chat

Ahora que hemos completado la configuración de facturación y creado un cliente de prueba, creemos la aplicación de chat con IA y seguimiento automático de tokens.
1

Set up your project

Crea un directorio nuevo e inicializa el proyecto:
2

Install dependencies

Instala los paquetes que necesitamos:
3

Configure TypeScript

Crea tsconfig.json:
tsconfig.json
Actualiza package.json para añadir el tipo de módulo y los scripts:
package.json
4

Create project structure

Crea las carpetas y los archivos:
5

Set up environment variables

Crea un archivo .env en la raíz del proyecto:
.env
Reemplaza los valores de marcador de posición por tus claves de API reales del Paso 2.
6

Create the backend server

Crea src/server.ts y copia este código completo del servidor:
Este es el servidor completo de chat con IA y facturación integrada:

Paso 6: Añade la interfaz de chat

Ahora añadamos una atractiva interfaz de chat con el historial completo de conversaciones. Crea public/index.html:
public/index.html

Paso 7: Prueba tu aplicación de chat

¡Es hora de probar nuestra aplicación de chat con IA y ver la facturación en acción! Asegurémonos de que todo funciona de principio a fin.
Lo que estamos probando: mantendremos algunas conversaciones con la IA, verificaremos que los eventos de tokens lleguen a Dodo Payments y confirmaremos que los cálculos de facturación sean correctos.
1

Start the server

Primero, asegúrate de que todo esté configurado:
  1. Comprueba que tu archivo .env contenga todas las claves de API del Paso 2
  2. Inicia el servidor de desarrollo:
Deberías ver:
¡El servidor está en ejecución! Es hora de chatear.
2

Open the chat interface

  1. Abre el navegador
  2. Ve a http://localhost:3000
  3. Deberías ver la atractiva interfaz de chat
Asegúrate de actualizar CUSTOMER_ID en server.ts con el ID de tu cliente de prueba del Paso 4.
3

Have your first conversation

¡Vamos a probarlo! Intenta enviar estos mensajes:
  1. “¿Qué es la inteligencia artificial?”
  2. “¿Cómo funciona el aprendizaje automático?”
  3. “¿Puedes explicar las redes neuronales?”
Observa cómo se actualiza el uso de tokens después de cada respuesta.
Si ves que la IA responde y aparecen los recuentos de tokens, ¡tu aplicación funciona!
4

Check your Dodo Payments dashboard

Ahora verifiquemos que los eventos se estén recibiendo:
  1. Abre el panel de control de Dodo Payments
  2. Ve a Usage BillingAI Token Usage Meter
  3. Haz clic en la pestaña Events
  4. Deberías ver tus eventos de chat en la lista
Qué debes buscar:
  • Nombres de eventos: ai_chat_usage
  • ID de cliente: el ID de tu cliente de prueba
Eventos del medidor
¡Deberías ver un evento por cada mensaje que hayas enviado!
5

Verify token counting

Enviemos algunos mensajes más y comprobemos si la agregación de tokens funciona correctamente:
  1. En tu medidor, ve a la pestaña Customers
  2. Busca tu cliente de prueba
  3. Comprueba la columna “Consumed Units”; debería mostrar el total de tokens utilizados
Tokens de clientes del medidor
¡El medidor suma automáticamente todos los valores de totalTokens!
6

Test the free tier

Utilicemos suficientes tokens para superar el nivel gratuito:
  1. Mantén varias conversaciones más (intenta alcanzar un total de aproximadamente 15,000 tokens o más)
  2. Vuelve a consultar la pestaña Customers del panel del medidor
  3. Ahora deberías ver:
    • Unidades consumidas: más de 15,000 tokens
    • Unidades facturables: 5,000 (se aplicaron 10,000 tokens gratuitos)
    • Precio total: aproximadamente $0.05
Prueba del nivel gratuito
¡Todo listo! La facturación basada en el uso funciona perfectamente. A los clientes se les cobrará automáticamente según su consumo real de tokens.

Solución de problemas

Problemas habituales y sus soluciones:
Posibles causas:
  • El nombre del evento no coincide exactamente con la configuración del medidor
  • El ID de cliente no existe en tu cuenta
  • La clave de API no es válida o ha caducado
  • Problemas de conectividad de red
Soluciones:
  1. Comprueba que el nombre del evento coincida exactamente con la configuración del medidor (distingue entre mayúsculas y minúsculas: ai_chat_usage)
  2. Comprueba que el ID de cliente exista en el panel de control de Dodo Payments
  3. Prueba la clave de API con una llamada de API sencilla
  4. Comprueba los registros del servidor para ver los mensajes de error
Posibles causas:
  • El modelo no devuelve información de uso
  • La versión del SDK es incorrecta
Soluciones:
  1. Comprueba si el modelo devuelve información de uso:
  1. Actualiza a la versión más reciente de Blueprints SDK: npm install @dodopayments/ingestion-blueprints@latest
Posibles causas:
  • La clave de API no corresponde al entorno
  • Hay espacios o comillas adicionales en el archivo .env
Soluciones:
  • Asegúrate de que la clave de prueba comience por test_ y la clave activa por live_
  • Elimina las comillas que rodeen las claves en el archivo .env
  • Genera una clave nueva si es necesario
¿Necesitas ayuda?

¡Enhorabuena! Has creado una aplicación de chat con IA

Ahora tienes una aplicación de chat con IA completamente funcional, con seguimiento automático del uso de tokens y facturación proporcionados por Dodo Payments. 🎉

Más información

LLM Blueprint

Obtén más información sobre LLM Ingestion Blueprint

Ingestion Blueprints SDK

Consulta el repositorio de GitHub para ver más ejemplos

Join Community

Obtén ayuda y comparte tus proyectos en Discord
Última modificación el 31 de julio de 2026