Skip to main content

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.
Guarda tus API keys de forma segura en variables de entorno. Nunca las incluyas en el control de versiones.
3

Create a Meter in Dodo Payments

Antes de realizar el seguimiento del uso, crea un medidor en tu dashboard de Dodo Payments:
  1. Inicia sesión en el Dashboard de Dodo Payments
  2. Ve a Products → Meters
  3. Haz clic en “Create Meter”
  4. 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 sum para sumar los recuentos de tokens
    • Over Property: Elige qué se debe seguir:
      • inputTokens - Realiza un seguimiento de los tokens de entrada/prompt
      • outputTokens - 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).
Para obtener instrucciones detalladas, consulta la Guía de facturación basada en el uso.
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 pruebas
  • live_mode - Úsalo en producción
Usa siempre test_mode durante el desarrollo para evitar afectar las métricas de 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.
Usa el ID de usuario o el ID de cliente de tu aplicación para garantizar una facturación precisa por cliente.
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:
Realiza un seguimiento del uso con Vercel AI SDK para obtener compatibilidad universal con LLM.
Métricas registradas:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • 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.
Realiza un seguimiento del uso de tokens en más de 200 modelos mediante la API unificada de OpenRouter.
Métricas registradas:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nombre del modelo
OpenRouter proporciona acceso a modelos de OpenAI, Anthropic, Google, Meta y muchos otros proveedores mediante una sola API.
Realiza un seguimiento automático del uso de tokens de los modelos GPT de OpenAI.
Métricas registradas:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nombre del modelo
Realiza un seguimiento del uso de tokens de los modelos Claude de Anthropic.
Métricas registradas:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • totalTokens calculado
  • Nombre del modelo
Realiza un seguimiento de la inferencia ultrarrápida de LLM con Groq.
Métricas registradas:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nombre del modelo
Realiza un seguimiento del uso de tokens de los modelos Gemini de Google mediante Google GenAI SDK.
Métricas registradas:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • 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:
Usa nombres de eventos diferentes para cada proveedor a fin de realizar un seguimiento independiente del uso en tus medidores.

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 utilizados
  • outputTokens - 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.

Última modificación el 31 de julio de 2026