Quick Start
Kom igång på 2 minuter med automatisk tokenspårning.
API Reference - Events Ingestion
Fullständig API-dokumentation för inmatning av användningshändelser.
API Reference - Meters
Läs mer om hur du skapar och konfigurerar mätare för fakturering.
Usage-Based Billing Guide
Omfattande guide till användningsbaserad fakturering med mätare.
Perfekt för SaaS-appar, AI-chattbotar, verktyg för innehållsgenerering och alla LLM-drivna applikationer som behöver användningsbaserad fakturering.
Snabbstart
Kom igång med automatisk LLM-tokenspårning på bara 2 minuter:1
Install the SDK
Installera Dodo Payments Ingestion Blueprints:
2
Get Your API Keys
Du behöver två API-nycklar:
- Dodo Payments API Key: Hämta den från Dodo Payments Dashboard
- LLM Provider API Key: Från AI SDK, OpenAI, Anthropic, Groq osv.
3
Create a Meter in Dodo Payments
Innan du spårar användning skapar du en mätare i din Dodo Payments-instrumentpanel:Detaljerade instruktioner finns i Guiden för användningsbaserad fakturering.
- Logga in på Dodo Payments Dashboard
- Gå till Products → Meters
- Klicka på “Create Meter”
- Konfigurera mätaren:
- Meter Name: Välj ett beskrivande namn (t.ex. “LLM Token Usage”)
- Event Name: Ange en unik händelseidentifierare (t.ex.
llm.chat_completion) - Aggregation Type: Välj
sumför att summera tokenantal - Over Property: Välj vad som ska spåras:
inputTokens– Spåra indata-/prompttokensoutputTokens– Spåra utdata-/slutförandetokens (inklusive resonemangstokens när det är tillämpligt)totalTokens– Spåra kombinerade indata- och utdatatokens
Event Name som du anger här måste exakt matcha det du skickar till SDK:t (skiftlägeskänsligt).
4
Track Token Usage
Wrapper:a din LLM-klient och börja spåra automatiskt:
Det var allt! Alla API-anrop spårar nu automatiskt tokenanvändningen och skickar händelser till Dodo Payments för fakturering.
Konfiguration
Tracker-konfiguration
Skapa en tracker en gång när applikationen startar, med följande obligatoriska parametrar:string
obligatorisk
Miljöläget för trackern.
test_mode– Använd för utveckling och testninglive_mode– Använd i produktion
string
obligatorisk
Händelsenamnet som utlöser din mätare. Måste exakt matcha det du konfigurerade i din Dodo Payments-mätare (skiftlägeskänsligt).
Detta händelsenamn kopplar din spårade användning till rätt mätare för faktureringsberäkningar.
Wrapper-konfiguration
När du wrapper din LLM-klient anger du följande parametrar:object
obligatorisk
Din LLM-klientinstans (OpenAI, Anthropic, Groq osv.).
string
obligatorisk
Den unika kundidentifieraren för fakturering. Den bör matcha ditt kund-ID i Dodo Payments.
object
Valfria ytterligare data som kopplas till spårningshändelsen. Användbart för filtrering och analys.
Komplett konfigurationsexempel
Automatisk spårning: SDK:t spårar automatiskt tokenanvändningen i bakgrunden utan att ändra svaret. Din kod förblir ren och identisk med kod som använder de ursprungliga leverantörs-SDK:erna.
Leverantörer som stöds
LLM Blueprint fungerar sömlöst med alla större LLM-leverantörer och aggregatorer:AI SDK (Vercel)
AI SDK (Vercel)
Spåra användning med Vercel AI SDK för universellt LLM-stöd.Spårade mått:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Modellnamn
När du använder modeller med resonemang via AI SDK (till exempel Googles Gemini 2.5 Flash med thinking mode) inkluderas resonemangstokens automatiskt i antalet
outputTokens för korrekt fakturering.OpenRouter
OpenRouter
Spåra tokenanvändning över fler än 200 modeller via OpenRouters enhetliga API.Spårade mått:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellnamn
OpenAI
OpenAI
Spåra automatiskt tokenanvändning från OpenAIs GPT-modeller.Spårade mått:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellnamn
Anthropic Claude
Anthropic Claude
Spåra tokenanvändning från Anthropics Claude-modeller.Spårade mått:
input_tokens→inputTokensoutput_tokens→outputTokens- Beräknade
totalTokens - Modellnamn
Groq
Groq
Spåra ultrasnabb LLM-inferens med Groq.Spårade mått:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Modellnamn
Google Gemini
Google Gemini
Spåra tokenanvändning från Googles Gemini-modeller via Google GenAI SDK.Spårade mått:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Modellversion
Gemini Thinking Mode: När du använder Gemini-modeller med förmåga till tänkande/resonemang (till exempel Gemini 2.5 Pro) inkluderar SDK:t automatiskt
thoughtsTokenCount (resonemangstokens) i outputTokens för att korrekt återspegla den fullständiga beräkningskostnaden.Avancerad användning
Flera leverantörer
Spåra användning över olika LLM-leverantörer med separata trackers:Express.js API-integration
Komplett exempel på hur LLM-spårning integreras i ett Express.js-API:Det som spåras
Varje LLM API-anrop skickar automatiskt en användningshändelse till Dodo Payments med följande struktur:Händelsefält
string
Unik identifierare för den specifika händelsen. Genereras automatiskt av SDK:t.Format:
llm_[timestamp]_[random]string
Det kund-ID du angav när du wrapper klienten. Används för fakturering.
string
Händelsenamnet som utlöser din mätare. Matchar din tracker-konfiguration.
string
ISO 8601-tidsstämpel för när händelsen inträffade.
object
Tokenanvändning och ytterligare spårningsdata:
inputTokens– Antalet använda indata-/prompttokensoutputTokens– Antalet använda utdata-/slutförandetokens (inklusive resonemangstokens när det är tillämpligt)totalTokens– Totalt antal tokens (indata + utdata)model– Den LLM-modell som användes (t.ex. “gpt-4”)provider– LLM-leverantören (om den ingår i wrapper-metadata)- Alla anpassade metadata som du angav när du wrapper klienten
Resonemangstokens: För modeller med resonemangsfunktioner inkluderar
outputTokens automatiskt både slutförandetokens och resonemangstokens.Din Dodo Payments-mätare använder fälten
metadata (särskilt inputTokens, outputTokens eller totalTokens) för att beräkna användning och fakturering.