Quick Start
Beginnen Sie in 2 Minuten mit der automatischen Token-Verfolgung.
API Reference - Events Ingestion
Vollständige API-Dokumentation zum Erfassen von Nutzungsereignissen.
API Reference - Meters
Erfahren Sie, wie Sie Zähler für die Abrechnung erstellen und konfigurieren.
Usage-Based Billing Guide
Umfassender Leitfaden zur nutzungsbasierten Abrechnung mit Zählern.
Perfekt für SaaS-Apps, KI-Chatbots, Content-Generierungstools und jede LLM-gestützte Anwendung, die nutzungsbasierte Abrechnung benötigt.
Schnellstart
Starten Sie mit der automatischen LLM-Token-Verfolgung in nur 2 Minuten:Get Your API Keys
Sie benötigen zwei API-Schlüssel:
- Dodo Payments API-Schlüssel: Holen Sie ihn sich vom Dodo Payments Dashboard
- LLM-Anbieter API-Schlüssel: Von AI SDK, OpenAI, Anthropic, Groq usw.
Create a Meter in Dodo Payments
Bevor Sie die Nutzung verfolgen, erstellen Sie einen Zähler in Ihrem Dodo Payments Dashboard:Für detaillierte Anweisungen siehe den Usage-Based Billing Guide.
- Anmelden beim Dodo Payments Dashboard
- Navigieren zu Produkte → Zähler
- Klicken Sie auf „Zähler erstellen“
- Konfigurieren Sie Ihren Zähler:
- Zählername: Wählen Sie einen beschreibenden Namen (z. B. „LLM Token Usage“)
- Ereignisname: Legen Sie eine eindeutige Ereigniskennzeichnung fest (z. B.
llm.chat_completion) - Aggregationstyp: Wählen Sie
sum, um Token-Zahlen aufzusummieren - Über Eigenschaft: Wählen Sie, was verfolgt werden soll:
inputTokens– Eingabe-/Prompt-Token verfolgenoutputTokens– Ausgabe-/Completion-Token verfolgen (schließt Reasoning-Token ein, falls zutreffend)totalTokens– Kombination aus Eingabe- und Ausgabetoken verfolgen
Der Ereignisname, den Sie hier festlegen, muss exakt mit dem übereinstimmen, was Sie an das SDK übergeben (Groß-/Kleinschreibung beachten).
Konfiguration
Tracker-Konfiguration
Erstellen Sie einen Tracker einmal beim Start der Anwendung mit diesen erforderlichen Parametern:Ihr Dodo Payments API-Schlüssel. Erhalten Sie ihn auf der API Keys-Seite.
Der Umgebungsmodus für den Tracker.
test_mode– Für Entwicklung und Tests verwendenlive_mode– Für die Produktion verwenden
Der Ereignisname, der Ihren Zähler auslöst. Muss exakt mit der Konfiguration Ihres Dodo Payments-Zählers übereinstimmen (Groß-/Kleinschreibung beachten).
Dieser Ereignisname verknüpft Ihre verfolgte Nutzung mit dem richtigen Zähler für die Abrechnungsberechnungen.
Wrapper-Konfiguration
Beim Umwickeln Ihres LLM-Clients geben Sie diese Parameter an:Ihre LLM-Clientinstanz (OpenAI, Anthropic, Groq usw.).
Die eindeutige Kundenkennung für die Abrechnung. Diese sollte mit Ihrer Kunden-ID in Dodo Payments übereinstimmen.
Optionale zusätzliche Daten, die an das Tracking-Ereignis angehängt werden. Nützlich zum Filtern und Analysieren.
Vollständiges Konfigurationsbeispiel
Automatische Verfolgung: Das SDK verfolgt Token-Nutzung automatisch im Hintergrund, ohne die Antwort zu verändern. Ihr Code bleibt sauber und identisch zur Nutzung der ursprünglichen Provider-SDKs.
Unterstützte Anbieter
Das LLM Blueprint funktioniert nahtlos mit allen großen LLM-Anbietern und Aggregatoren:AI SDK (Vercel)
AI SDK (Vercel)
Verfolgen Sie die Nutzung mit dem Vercel AI SDK für universelle LLM-Unterstützung.Verfolgte Metriken:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Modellname
Beim Einsatz von reasoning-fähigen Modellen über das AI SDK (z. B. Googles Gemini 2.5 Flash mit Thinking Mode) werden Reasoning-Token automatisch in die
outputTokens-Zählung einbezogen, um eine genaue Abrechnung zu gewährleisten.OpenRouter
OpenRouter
Verfolgen Sie Token-Nutzung über 200+ Modelle hinweg über die vereinheitlichte API von OpenRouter.Verfolgte Metriken:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellname
OpenAI
OpenAI
Verfolgen Sie automatisch die Token-Nutzung aus OpenAIs GPT-Modellen.Verfolgte Metriken:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellname
Anthropic Claude
Anthropic Claude
Verfolgen Sie die Token-Nutzung aus Anthropics Claude-Modellen.Verfolgte Metriken:
input_tokens→inputTokensoutput_tokens→outputTokens- Berechnete
totalTokens - Modellname
Groq
Groq
Verfolgen Sie ultraschnelle LLM-Inferenz mit Groq.Verfolgte Metriken:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellname
Google Gemini
Google Gemini
Verfolgen Sie die Token-Nutzung von Googles Gemini-Modellen über das Google GenAI SDK.Verfolgte Metriken:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Modellversion
Gemini Thinking Mode: Wenn Sie Gemini-Modelle mit Thinking-/Reasoning-Fähigkeiten verwenden (z. B. Gemini 2.5 Pro), fügt das SDK automatisch
thoughtsTokenCount (Reasoning-Token) zur outputTokens hinzu, um die vollständigen Rechenkosten genau widerzuspiegeln.Erweiterte Nutzung
Mehrere Anbieter
Verfolgen Sie die Nutzung über verschiedene LLM-Anbieter mit separaten Trackern:Express.js API-Integration
Vollständiges Beispiel zur Integration der LLM-Verfolgung in eine Express.js-API:Was verfolgt wird
Jeder LLM-API-Aufruf sendet automatisch ein Nutzungsevent an Dodo Payments mit folgender Struktur:Ereignisfelder
Eindeutige Kennung für dieses spezifische Ereignis. Wird vom SDK automatisch generiert.Format:
llm_[timestamp]_[random]Die Kunden-ID, die Sie beim Umwickeln des Clients angegeben haben. Wird für die Abrechnung verwendet.
Der Ereignisname, der Ihren Zähler auslöst. Entspricht Ihrer Tracker-Konfiguration.
ISO-8601-Zeitstempel, wann das Ereignis stattgefunden hat.
Token-Nutzung und zusätzliche Tracking-Daten:
inputTokens– Anzahl der verwendeten Eingabe-/Prompt-TokenoutputTokens– Anzahl der verwendeten Ausgabe-/Completion-Token (schließt Reasoning-Token ein, falls zutreffend)totalTokens– Gesamte Token (Eingabe + Ausgabe)model– Das verwendete LLM-Modell (z. B. „gpt-4“)provider– Der LLM-Anbieter (falls in den Wrapper-Metadaten enthalten)- Alle benutzerdefinierten Metadaten, die Sie beim Umwickeln des Clients angegeben haben
Reasoning-Token: Bei Modellen mit Reasoning-Fähigkeiten beinhaltet
outputTokens automatisch sowohl Completion- als auch Reasoning-Token.Ihr Dodo Payments-Zähler verwendet die
metadata-Felder (insbesondere inputTokens, outputTokens oder totalTokens), um die Nutzung und Abrechnung zu berechnen.