Skip to main content

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.
Lagra dina API-nycklar säkert i miljövariabler. Checka aldrig in dem i versionshanteringen.
3

Create a Meter in Dodo Payments

Innan du spårar användning skapar du en mätare i din Dodo Payments-instrumentpanel:
  1. Logga inDodo Payments Dashboard
  2. Gå till Products → Meters
  3. Klicka på “Create Meter”
  4. 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 sum för att summera tokenantal
    • Over Property: Välj vad som ska spåras:
      • inputTokens – Spåra indata-/prompttokens
      • outputTokens – 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).
Detaljerade instruktioner finns i Guiden för användningsbaserad fakturering.
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
Din Dodo Payments API-nyckel. Hämta den från sidan API Keys.
string
obligatorisk
Miljöläget för trackern.
  • test_mode – Använd för utveckling och testning
  • live_mode – Använd i produktion
Använd alltid test_mode under utveckling för att undvika att påverka produktionsmått.
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.
Använd applikationens användar-ID eller kund-ID för att säkerställa korrekt fakturering per kund.
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:
Spåra användning med Vercel AI SDK för universellt LLM-stöd.
Spårade mått:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • 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.
Spåra tokenanvändning över fler än 200 modeller via OpenRouters enhetliga API.
Spårade mått:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Modellnamn
OpenRouter ger åtkomst till modeller från OpenAI, Anthropic, Google, Meta och många fler leverantörer via ett enda API.
Spåra automatiskt tokenanvändning från OpenAIs GPT-modeller.
Spårade mått:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Modellnamn
Spåra tokenanvändning från Anthropics Claude-modeller.
Spårade mått:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • Beräknade totalTokens
  • Modellnamn
Spåra ultrasnabb LLM-inferens med Groq.
Spårade mått:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Modellnamn
Spåra tokenanvändning från Googles Gemini-modeller via Google GenAI SDK.
Spårade mått:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • 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:
Använd olika händelsenamn för olika leverantörer för att spåra användningen separat i dina mätare.

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-/prompttokens
  • outputTokens – 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.

Senast ändrad 31 juli 2026