Skip to main content

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.
Stockez vos clés API de manière sécurisée dans des variables d’environnement. Ne les intégrez jamais à votre système de contrôle de version.
3

Create a Meter in Dodo Payments

Avant de suivre l’utilisation, créez un meter dans votre tableau de bord Dodo Payments :
  1. Connectez-vous au tableau de bord Dodo Payments
  2. Accédez à Products → Meters
  3. Cliquez sur “Create Meter”
  4. 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 sum pour additionner le nombre de tokens
    • Over Property : choisissez ce que vous souhaitez suivre :
      • inputTokens - Suivre les tokens d’entrée/de prompt
      • outputTokens - 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).
Pour des instructions détaillées, consultez le Guide de la facturation basée sur l’utilisation.
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 tests
  • live_mode - À utiliser en production
Utilisez toujours test_mode pendant le développement afin de ne pas affecter les métriques de 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.
Utilisez l’ID utilisateur ou l’ID client de votre application pour garantir une facturation précise par client.
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 :
Suivez l’utilisation avec le Vercel AI SDK pour une prise en charge universelle des LLM.
Métriques suivies :
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • 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.
Suivez l’utilisation des tokens sur plus de 200 modèles via l’API unifiée d’OpenRouter.
Métriques suivies :
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nom du modèle
OpenRouter donne accès aux modèles d’OpenAI, Anthropic, Google, Meta et de nombreux autres fournisseurs via une seule API.
Suivez automatiquement l’utilisation des tokens des modèles GPT d’OpenAI.
Métriques suivies :
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nom du modèle
Suivez l’utilisation des tokens des modèles Claude d’Anthropic.
Métriques suivies :
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • totalTokens calculé
  • Nom du modèle
Suivez l’inférence LLM ultra-rapide avec Groq.
Métriques suivies :
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nom du modèle
Suivez l’utilisation des tokens des modèles Gemini de Google via le Google GenAI SDK.
Métriques suivies :
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • 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 :
Utilisez des noms d’événements différents pour chaque fournisseur afin de suivre séparément leur utilisation dans vos meters.

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és
  • outputTokens - 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 used
  • outputTokens - 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.

Dernière modification le 31 juillet 2026