Vai al contenuto principale

Quick Start

Inizia in 2 minuti con il monitoraggio automatico dei token.

API Reference - Events Ingestion

Documentazione API completa per l’ingestione degli eventi di utilizzo.

API Reference - Meters

Scopri come creare e configurare i contatori per la fatturazione.

Usage-Based Billing Guide

Guida completa alla fatturazione basata sull’utilizzo con i contatori.
Perfetto per app SaaS, chatbot AI, strumenti di generazione di contenuti e qualsiasi applicazione alimentata da LLM che richieda fatturazione basata sull’utilizzo.

Inizio Veloce

Inizia con il monitoraggio automatico dei token LLM in soli 2 minuti:
1

Install the SDK

Installa i Blueprints di ingestione di Dodo Payments:
2

Get Your API Keys

Ti serviranno due chiavi API:
  • Chiave API di Dodo Payments: Ottienila dal Dashboard di Dodo Payments
  • Chiave API del Fornitore LLM: Da AI SDK, OpenAI, Anthropic, Groq, ecc.
Conserva le tue chiavi API in modo sicuro nelle variabili d’ambiente. Non inserirle mai nel controllo versione.
3

Create a Meter in Dodo Payments

Prima di monitorare l’utilizzo, crea un contatore nella tua dashboard di Dodo Payments:
  1. Accedi a Dodo Payments Dashboard
  2. Vai su Prodotti → Contatori
  3. Clicca “Crea contatore”
  4. Configura il tuo contatore:
    • Nome del contatore: scegli un nome descrittivo (es. “Utilizzo token LLM”)
    • Nome evento: imposta un identificatore evento univoco (es. llm.chat_completion)
    • Tipo di aggregazione: seleziona sum per sommare i conteggi dei token
    • Proprietà su cui operare: scegli cosa monitorare:
      • inputTokens - Monitora i token di input/prompt
      • outputTokens - Monitora i token di output/completamento (include i token di ragionamento quando applicabile)
      • totalTokens - Monitora i token combinati input + output
Il Nome evento che imposti qui deve corrispondere esattamente a quello che passi all’SDK (case-sensitive).
Per istruzioni dettagliate, consulta la Guida alla fatturazione basata sull’utilizzo.
4

Track Token Usage

Avvolgi il tuo client LLM e inizia a monitorare automaticamente:
Fatelo! Ora ogni chiamata API monitora automaticamente l’utilizzo dei token e invia eventi a Dodo Payments per la fatturazione.

Configurazione

Configurazione del Tracker

Crea un tracker una sola volta all’avvio dell’applicazione con questi parametri richiesti:
apiKey
string
obbligatorio
La tua chiave API di Dodo Payments. Ottienila dalla pagina delle chiavi API.
environment
string
obbligatorio
La modalità dell’ambiente per il tracker.
  • test_mode - Utilizza per sviluppo e test
  • live_mode - Utilizza per la produzione
Usa sempre test_mode durante lo sviluppo per evitare di influenzare le metriche di produzione.
eventName
string
obbligatorio
Il nome dell’evento che attiva il tuo contatore. Deve corrispondere esattamente a quello configurato nel tuo contatore Dodo Payments (case-sensitive).
Questo nome evento collega l’utilizzo monitorato al contatore corretto per i calcoli di fatturazione.

Configurazione del Wrapper

Quando avvolgi il tuo client LLM, fornisci questi parametri:
client
object
obbligatorio
La tua istanza del client LLM (OpenAI, Anthropic, Groq, ecc.).
customerId
string
obbligatorio
L’identificatore univoco del cliente per la fatturazione. Deve corrispondere al tuo ID cliente in Dodo Payments.
Usa l’ID utente o l’ID cliente della tua applicazione per garantire una fatturazione accurata per cliente.
metadata
object
Dati aggiuntivi opzionali da allegare all’evento di monitoraggio. Utile per filtraggio e analisi.

Esempio Completo di Configurazione

Monitoraggio automatico: l’SDK monitora automaticamente l’utilizzo dei token in background senza modificare la risposta. Il tuo codice rimane pulito e identico all’utilizzo degli SDK originali del provider.

Fornitori Supportati

Il LLM Blueprint funziona senza problemi con tutti i principali fornitori e aggregatori di LLM:
Monitora l’utilizzo con l’SDK Vercel AI per un supporto universale agli LLM.
Metriche monitorate:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • Nome del modello
Quando usi modelli con capacità di ragionamento tramite AI SDK (come il Gemini 2.5 Flash di Google con modalità thinking), i token di ragionamento sono automaticamente inclusi nel conteggio outputTokens per una fatturazione accurata.
Monitora l’utilizzo dei token per oltre 200 modelli tramite l’API unificata di OpenRouter.
Metriche monitorate:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nome del modello
OpenRouter offre accesso a modelli di OpenAI, Anthropic, Google, Meta e molti altri provider tramite un’unica API.
Monitora automaticamente l’utilizzo dei token dei modelli GPT di OpenAI.
Metriche monitorate:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nome del modello
Monitora l’utilizzo dei token dei modelli Claude di Anthropic.
Metriche monitorate:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • totalTokens calcolato
  • Nome del modello
Monitora inferenze LLM ultra-veloci con Groq.
Metriche monitorate:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nome del modello
Monitora l’utilizzo dei token dei modelli Gemini di Google tramite il Google GenAI SDK.
Metriche monitorate:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • Versione del modello
Modalità Gemini Thinking: Quando usi i modelli Gemini con capacità di thinking/ragionamento (come Gemini 2.5 Pro), l’SDK include automaticamente thoughtsTokenCount (token di ragionamento) in outputTokens per riflettere accuratamente il costo computazionale totale.

Utilizzo Avanzato

Molteplici Fornitori

Monitora l’uso tra diversi fornitori LLM con tracker separati:
Usa nomi evento diversi per provider differenti per monitorare separatamente l’utilizzo nei tuoi contatori.

Integrazione API Express.js

Esempio completo di integrazione del monitoraggio LLM in un’API Express.js:

Cosa Viene Monitorato

Ogni chiamata API LLM invia automaticamente un evento di utilizzo a Dodo Payments con la seguente struttura:

Campi Evento

event_id
string
Identificatore univoco per questo evento specifico. Generato automaticamente dall’SDK.Formato: llm_[timestamp]_[random]
customer_id
string
L’ID cliente che hai fornito quando hai avvolto il client. Usato per la fatturazione.
event_name
string
Il nome evento che attiva il tuo contatore. Corrisponde alla configurazione del tracker.
timestamp
string
Timestamp ISO 8601 in cui si è verificato l’evento.
metadata
object
Utilizzo dei token e dati aggiuntivi di monitoraggio:
  • inputTokens - Numero di token di input/prompt utilizzati
  • outputTokens - Numero di token di output/completamento utilizzati (include i token di ragionamento quando applicabile)
  • totalTokens - Token totali (input + output)
  • model - Il modello LLM utilizzato (es. “gpt-4”)
  • provider - Il provider LLM (se incluso nei metadati del wrapper)
  • Qualsiasi metadato personalizzato fornito al momento dell’avvolgimento del client
  • inputTokens - Numero di token di input/prompt utilizzati
  • outputTokens - Numero di token di output/completamento utilizzati (inclusi i token di ragionamento quando applicabile)
  • totalTokens - Token totali (input + output)
  • model - Il modello LLM utilizzato (es. “gpt-4”)
  • provider - Il fornitore LLM (se incluso nei metadati del wrapper)
  • Qualsiasi metadato personalizzato fornito durante l’involucro del client
Token di ragionamento: per i modelli con capacità di ragionamento, outputTokens include automaticamente sia i token di completamento sia quelli di ragionamento.
Il tuo contatore di Dodo Payments utilizza i campi metadata (specialmente inputTokens, outputTokens o totalTokens) per calcolare l’utilizzo e la fatturazione.
Ultima modifica il 1 aprile 2026