Quick Start
Commencez en 2 minutes grâce au suivi automatique des tokens.
API Reference - Events Ingestion
Documentation complète de l’API pour l’ingestion des événements d’utilisation.
API Reference - Meters
Découvrez comment créer et configurer des meters pour la facturation.
Usage-Based Billing Guide
Guide complet de la facturation basée sur l’utilisation avec des meters.
Parfait pour les applications SaaS, les chatbots IA, les outils de génération de contenu et toute application basée sur un LLM nécessitant une facturation basée sur l’utilisation.
Démarrage rapide
Commencez à suivre automatiquement les tokens LLM en seulement 2 minutes :1
Install the SDK
Installez les Ingestion Blueprints de Dodo Payments :
2
Get Your API Keys
Vous aurez besoin de deux clés API :
- Clé API Dodo Payments : récupérez-la dans le tableau de bord Dodo Payments
- Clé API du fournisseur LLM : auprès de AI SDK, OpenAI, Anthropic, Groq, etc.
3
Create a Meter in Dodo Payments
Avant de suivre l’utilisation, créez un meter dans votre tableau de bord Dodo Payments :Pour des instructions détaillées, consultez le Guide de la facturation basée sur l’utilisation.
- Connectez-vous au tableau de bord Dodo Payments
- Accédez à Products → Meters
- Cliquez sur “Create Meter”
- Configurez votre meter :
- Nom du meter : choisissez un nom descriptif (par ex. : “Utilisation des tokens LLM”)
- Nom de l’événement : définissez un identifiant d’événement unique (par ex. :
llm.chat_completion) - Type d’agrégation : sélectionnez
sumpour additionner le nombre de tokens - Over Property : choisissez ce que vous souhaitez suivre :
inputTokens- Suivre les tokens d’entrée/de promptoutputTokens- Suivre les tokens de sortie/de completion (inclut les tokens de raisonnement lorsque cela s’applique)totalTokens- Suivre le nombre total de tokens d’entrée et de sortie
Le nom de l’événement défini ici doit correspondre exactement à celui transmis au SDK (sensible à la casse).
4
Track Token Usage
Entourez votre client LLM et commencez le suivi automatiquement :
C’est tout ! Chaque appel API suit désormais automatiquement l’utilisation des tokens et envoie les événements à Dodo Payments pour la facturation.
Configuration
Configuration du tracker
Créez un tracker au démarrage de l’application avec les paramètres obligatoires suivants :string
requis
Votre clé API Dodo Payments. Récupérez-la depuis la page des clés API.
string
requis
Le mode d’environnement du tracker.
test_mode- À utiliser pour le développement et les testslive_mode- À utiliser en production
string
requis
Le nom de l’événement qui déclenche votre meter. Il doit correspondre exactement à celui configuré dans votre meter Dodo Payments (sensible à la casse).
Ce nom d’événement associe votre utilisation suivie au meter approprié pour les calculs de facturation.
Configuration du wrapper
Lorsque vous enveloppez votre client LLM, fournissez les paramètres suivants :object
requis
Votre instance de client LLM (OpenAI, Anthropic, Groq, etc.).
string
requis
L’identifiant client unique utilisé pour la facturation. Il doit correspondre à votre ID client dans Dodo Payments.
object
Données supplémentaires facultatives à associer à l’événement de suivi. Utiles pour le filtrage et l’analyse.
Exemple complet de configuration
Suivi automatique : le SDK suit automatiquement l’utilisation des tokens en arrière-plan sans modifier la réponse. Votre code reste propre et identique à celui utilisé avec les SDK des fournisseurs d’origine.
Fournisseurs pris en charge
Le Blueprint LLM fonctionne parfaitement avec tous les principaux fournisseurs et agrégateurs de LLM :AI SDK (Vercel)
AI SDK (Vercel)
Suivez l’utilisation avec le Vercel AI SDK pour une prise en charge universelle des LLM.Métriques suivies :
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Nom du modèle
Lorsque vous utilisez des modèles capables de raisonnement via AI SDK (comme Gemini 2.5 Flash de Google avec le mode thinking), les tokens de raisonnement sont automatiquement inclus dans le décompte
outputTokens pour une facturation précise.OpenRouter
OpenRouter
Suivez l’utilisation des tokens sur plus de 200 modèles via l’API unifiée d’OpenRouter.Métriques suivies :
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nom du modèle
OpenAI
OpenAI
Suivez automatiquement l’utilisation des tokens des modèles GPT d’OpenAI.Métriques suivies :
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nom du modèle
Anthropic Claude
Anthropic Claude
Suivez l’utilisation des tokens des modèles Claude d’Anthropic.Métriques suivies :
input_tokens→inputTokensoutput_tokens→outputTokenstotalTokenscalculé- Nom du modèle
Groq
Groq
Suivez l’inférence LLM ultra-rapide avec Groq.Métriques suivies :
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nom du modèle
Google Gemini
Google Gemini
Suivez l’utilisation des tokens des modèles Gemini de Google via le Google GenAI SDK.Métriques suivies :
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Version du modèle
Mode Thinking de Gemini : lorsque vous utilisez des modèles Gemini dotés de capacités de thinking/reasoning (comme Gemini 2.5 Pro), le SDK inclut automatiquement
thoughtsTokenCount (tokens de raisonnement) dans outputTokens afin de refléter précisément le coût computationnel total.Utilisation avancée
Plusieurs fournisseurs
Suivez l’utilisation auprès de différents fournisseurs LLM avec des trackers distincts :Intégration de l’API Express.js
Exemple complet d’intégration du suivi LLM dans une API Express.js :Éléments suivis
Chaque appel API LLM envoie automatiquement un événement d’utilisation à Dodo Payments avec la structure suivante :Champs de l’événement
string
Identifiant unique de cet événement spécifique. Généré automatiquement par le SDK.Format :
llm_[timestamp]_[random]string
L’ID client fourni lors de l’encapsulation du client. Utilisé pour la facturation.
string
Le nom de l’événement qui déclenche votre meter. Correspond à la configuration de votre tracker.
string
Horodatage ISO 8601 auquel l’événement s’est produit.
object
Utilisation des tokens et données de suivi supplémentaires :
inputTokens- Nombre de tokens d’entrée/de prompt utilisésoutputTokens- Nombre de tokens de sortie/de completion utilisés (inclut les tokens de raisonnement lorsque cela s’applique)totalTokens- Nombre total de tokens (entrée + sortie)model- Modèle LLM utilisé (par ex. : “gpt-4”)provider- Fournisseur LLM (s’il est inclus dans les métadonnées du wrapper)- Toutes les métadonnées personnalisées fournies lors de l’encapsulation du client
Tokens de raisonnement : pour les modèles dotés de capacités de raisonnement,
outputTokens inclut automatiquement les tokens de completion et de raisonnement.Votre meter Dodo Payments utilise les champs
metadata (notamment inputTokens, outputTokens ou totalTokens) pour calculer l’utilisation et la facturation.string
ISO 8601 timestamp when the event occurred.
object
Token usage and additional tracking data:
inputTokens- Number of input/prompt tokens usedoutputTokens- Number of output/completion tokens used (includes reasoning tokens when applicable)totalTokens- Total tokens (input + output)model- The LLM model used (e.g., “gpt-4”)provider- The LLM provider (if included in wrapper metadata)- Any custom metadata you provided when wrapping the client
Reasoning Tokens: For models with reasoning capabilities,
outputTokens automatically includes both the completion tokens and reasoning tokens.Your Dodo Payments meter uses the
metadata fields (especially inputTokens, outputTokens or totalTokens) to calculate usage and billing.