Quick Start
Comienza en 2 minutos con el seguimiento automático de tokens.
API Reference - Events Ingestion
Documentación completa de la API para ingerir eventos de uso.
API Reference - Meters
Aprende a crear y configurar medidores para la facturación.
Usage-Based Billing Guide
Guía completa de facturación basada en el uso con medidores.
Ideal para aplicaciones SaaS, chatbots de AI, herramientas de generación de contenido y cualquier aplicación basada en LLM que necesite facturación basada en el uso.
Inicio rápido
Comienza a realizar un seguimiento automático de los tokens de LLM en solo 2 minutos:1
Install the SDK
Instala los Ingestion Blueprints de Dodo Payments:
2
Get Your API Keys
Necesitarás dos API keys:
- API key de Dodo Payments: Obtenla en el Dashboard de Dodo Payments
- API key del proveedor de LLM: De AI SDK, OpenAI, Anthropic, Groq, etc.
3
Create a Meter in Dodo Payments
Antes de realizar el seguimiento del uso, crea un medidor en tu dashboard de Dodo Payments:Para obtener instrucciones detalladas, consulta la Guía de facturación basada en el uso.
- Inicia sesión en el Dashboard de Dodo Payments
- Ve a Products → Meters
- Haz clic en “Create Meter”
- Configura tu medidor:
- Meter Name: Elige un nombre descriptivo (por ejemplo, “LLM Token Usage”)
- Event Name: Establece un identificador de evento único (por ejemplo,
llm.chat_completion) - Aggregation Type: Selecciona
sumpara sumar los recuentos de tokens - Over Property: Elige qué se debe seguir:
inputTokens- Realiza un seguimiento de los tokens de entrada/promptoutputTokens- Realiza un seguimiento de los tokens de salida/completado (incluye tokens de razonamiento cuando corresponda)totalTokens- Realiza un seguimiento de los tokens combinados de entrada + salida
El Event Name que establezcas aquí debe coincidir exactamente con el que pases al SDK (distingue mayúsculas de minúsculas).
4
Track Token Usage
Envuelve tu cliente de LLM y comienza el seguimiento automáticamente:
¡Eso es todo! Cada llamada a la API realiza ahora un seguimiento automático del uso de tokens y envía eventos a Dodo Payments para la facturación.
Configuración
Configuración del tracker
Crea un tracker una vez al iniciar la aplicación con estos parámetros obligatorios:string
requerido
Tu API key de Dodo Payments. Obtenla en la página de API Keys.
string
requerido
El modo de entorno del tracker.
test_mode- Úsalo para desarrollo y pruebaslive_mode- Úsalo en producción
string
requerido
El nombre del evento que activa tu medidor. Debe coincidir exactamente con lo que configuraste en tu medidor de Dodo Payments (distingue mayúsculas de minúsculas).
Este nombre de evento vincula el uso registrado con el medidor correcto para los cálculos de facturación.
Configuración del wrapper
Al envolver tu cliente de LLM, proporciona estos parámetros:object
requerido
Tu instancia de cliente de LLM (OpenAI, Anthropic, Groq, etc.).
string
requerido
El identificador único del cliente para la facturación. Debe coincidir con tu ID de cliente en Dodo Payments.
object
Datos adicionales opcionales que se adjuntan al evento de seguimiento. Son útiles para el filtrado y el análisis.
Ejemplo de configuración completa
Seguimiento automático: El SDK realiza un seguimiento automático del uso de tokens en segundo plano sin modificar la respuesta. Tu código permanece limpio e idéntico al uso de los SDK originales de los proveedores.
Proveedores compatibles
El LLM Blueprint funciona de forma fluida con los principales proveedores y agregadores de LLM:AI SDK (Vercel)
AI SDK (Vercel)
Realiza un seguimiento del uso con Vercel AI SDK para obtener compatibilidad universal con LLM.Métricas registradas:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Nombre del modelo
Al usar modelos con capacidad de razonamiento mediante AI SDK (como Gemini 2.5 Flash de Google con el modo de pensamiento), los tokens de razonamiento se incluyen automáticamente en el recuento de
outputTokens para una facturación precisa.OpenRouter
OpenRouter
Realiza un seguimiento del uso de tokens en más de 200 modelos mediante la API unificada de OpenRouter.Métricas registradas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nombre del modelo
OpenAI
OpenAI
Realiza un seguimiento automático del uso de tokens de los modelos GPT de OpenAI.Métricas registradas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nombre del modelo
Anthropic Claude
Anthropic Claude
Realiza un seguimiento del uso de tokens de los modelos Claude de Anthropic.Métricas registradas:
input_tokens→inputTokensoutput_tokens→outputTokenstotalTokenscalculado- Nombre del modelo
Groq
Groq
Realiza un seguimiento de la inferencia ultrarrápida de LLM con Groq.Métricas registradas:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nombre del modelo
Google Gemini
Google Gemini
Realiza un seguimiento del uso de tokens de los modelos Gemini de Google mediante Google GenAI SDK.Métricas registradas:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Versión del modelo
Modo de pensamiento de Gemini: Al usar modelos Gemini con capacidades de pensamiento/razonamiento (como Gemini 2.5 Pro), el SDK incluye automáticamente
thoughtsTokenCount (tokens de razonamiento) en outputTokens para reflejar con precisión el costo computacional total.Uso avanzado
Varios proveedores
Realiza un seguimiento del uso en distintos proveedores de LLM con trackers independientes:Integración de la API de Express.js
Ejemplo completo de integración del seguimiento de LLM en una API de Express.js:Qué se registra
Cada llamada a la API de LLM envía automáticamente un evento de uso a Dodo Payments con la siguiente estructura:Campos del evento
string
Identificador único de este evento específico. El SDK lo genera automáticamente.Formato:
llm_[timestamp]_[random]string
El ID de cliente que proporcionaste al envolver el cliente. Se utiliza para la facturación.
string
El nombre del evento que activa tu medidor. Coincide con la configuración de tu tracker.
string
Marca de tiempo ISO 8601 en la que ocurrió el evento.
object
Uso de tokens y datos de seguimiento adicionales:
inputTokens- Número de tokens de entrada/prompt utilizadosoutputTokens- Número de tokens de salida/completado utilizados (incluye tokens de razonamiento cuando corresponda)totalTokens- Tokens totales (entrada + salida)model- Modelo de LLM utilizado (por ejemplo, “gpt-4”)provider- Proveedor de LLM (si se incluye en los metadatos del wrapper)- Cualquier metadata personalizada que hayas proporcionado al envolver el cliente
Tokens de razonamiento: En los modelos con capacidades de razonamiento,
outputTokens incluye automáticamente tanto los tokens de completado como los tokens de razonamiento.Tu medidor de Dodo Payments utiliza los campos
metadata (especialmente inputTokens, outputTokens o totalTokens) para calcular el uso y la facturación.