Quick Start
Mulai dalam 2 menit dengan pelacakan token otomatis.
API Reference - Events Ingestion
Dokumentasi API lengkap untuk menginjeksi peristiwa penggunaan.
API Reference - Meters
Pelajari cara membuat dan mengonfigurasi meter untuk penagihan.
Usage-Based Billing Guide
Panduan komprehensif untuk penagihan berbasis penggunaan dengan meter.
Sempurna untuk aplikasi SaaS, chatbot AI, alat generasi konten, dan aplikasi bertenaga LLM lainnya yang memerlukan penagihan berbasis penggunaan.
Quick Start
Mulai dengan pelacakan token LLM otomatis hanya dalam 2 menit:1
Install the SDK
Instal Dodo Payments Ingestion Blueprints:
2
Get Your API Keys
Anda akan memerlukan dua kunci API:
- Dodo Payments API Key: Dapatkan dari Dodo Payments Dashboard
- LLM Provider API Key: Dari AI SDK, OpenAI, Anthropic, Groq, dll.
3
Create a Meter in Dodo Payments
Sebelum melacak penggunaan, buat meter di dasbor Dodo Payments Anda:Untuk instruksi lebih rinci, lihat Usage-Based Billing Guide.
- Login ke Dodo Payments Dashboard
- Navigasi ke Produk → Meter
- Klik “Buat Meter”
- Konfigurasi meter Anda:
- Nama Meter: Pilih nama deskriptif (misalnya, “Penggunaan Token LLM”)
- Nama Peristiwa: Atur pengidentifikasi peristiwa yang unik (misalnya,
llm.chat_completion) - Tipe Agregasi: Pilih
sumuntuk menjumlahkan jumlah token - Atas Properti: Pilih apa yang akan dilacak:
inputTokens- Lacak token input/promptoutputTokens- Lacak token output/kompleksi (termasuk token penalaran jika berlaku)totalTokens- Lacak token gabungan input + output
Nama Peristiwa yang Anda atur di sini harus cocok persis dengan apa yang Anda kirimkan ke SDK (sensitif terhadap huruf besar/kecil).
4
Track Token Usage
Bungkus klien LLM Anda dan mulai melacak secara otomatis:
Itu saja! Setiap panggilan API sekarang secara otomatis melacak penggunaan token dan mengirimkan peristiwa ke Dodo Payments untuk penagihan.
Konfigurasi
Konfigurasi Pelacak
Buat pelacak sekali saat aplikasi dimulai dengan parameter yang diperlukan ini:Kunci API Dodo Payments Anda. Dapatkan dari halaman API Keys.
Mode lingkungan untuk pelacak.
test_mode- Gunakan untuk pengembangan dan pengujianlive_mode- Gunakan untuk produksi
Nama peristiwa yang memicu meter Anda. Harus cocok persis dengan apa yang Anda konfigurasi di meter Dodo Payments Anda (sensitif terhadap huruf besar/kecil).
Nama peristiwa ini menghubungkan penggunaan yang Anda lacak ke meter yang benar untuk perhitungan penagihan.
Konfigurasi Pembungkus
Saat membungkus klien LLM Anda, berikan parameter ini:Instansi klien LLM Anda (OpenAI, Anthropic, Groq, dll.).
Pengidentifikasi pelanggan unik untuk penagihan. Ini harus cocok dengan ID pelanggan Anda di Dodo Payments.
Data tambahan opsional untuk dilampirkan pada peristiwa pelacakan. Berguna untuk penyaringan dan analisis.
Contoh Konfigurasi Lengkap
Pelacakan Otomatis: SDK secara otomatis melacak penggunaan token di latar belakang tanpa memodifikasi respons. Kode Anda tetap bersih dan identik dengan menggunakan SDK penyedia asli.
Penyedia yang Didukung
LLM Blueprint bekerja dengan lancar dengan semua penyedia dan agregator LLM utama:AI SDK (Vercel)
AI SDK (Vercel)
Lacak penggunaan dengan Vercel AI SDK untuk dukungan LLM universal.Metrik yang Dilacak:
inputTokens→inputTokensoutputTokens+reasoningTokens→outputTokenstotalTokens→totalTokens- Nama model
Saat menggunakan model yang mampu penalaran melalui AI SDK (seperti Gemini 2.5 Flash dari Google dengan mode berpikir), token penalaran secara otomatis termasuk dalam jumlah
outputTokens untuk penagihan yang akurat.OpenRouter
OpenRouter
Lacak penggunaan token di lebih dari 200 model melalui API terpadu OpenRouter.Metrik yang Dilacak:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nama model
OpenAI
OpenAI
Lacak penggunaan token dari model GPT OpenAI secara otomatis.Metrik yang Dilacak:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nama model
Anthropic Claude
Anthropic Claude
Lacak penggunaan token dari model Claude milik Anthropic.Metrik yang Dilacak:
input_tokens→inputTokensoutput_tokens→outputTokenstotalTokensyang dihitung- Nama model
Groq
Groq
Lacak inferensi LLM ultra-cepat dengan Groq.Metrik yang Dilacak:
prompt_tokens→inputTokenscompletion_tokens→outputTokenstotal_tokens→totalTokens- Nama model
Google Gemini
Google Gemini
Lacak penggunaan token dari model Gemini milik Google melalui Google GenAI SDK.Metrik yang Dilacak:
promptTokenCount→inputTokenscandidatesTokenCount+thoughtsTokenCount→outputTokenstotalTokenCount→totalTokens- Versi model
Mode Berpikir Gemini: Saat menggunakan model Gemini dengan kemampuan berpikir/penalaran (seperti Gemini 2.5 Pro), SDK secara otomatis menyertakan
thoughtsTokenCount (token penalaran) dalam outputTokens untuk mencerminkan biaya komputasi penuh dengan akurat.Penggunaan Lanjutan
Beberapa Penyedia
Lacak penggunaan di berbagai penyedia LLM dengan pelacak terpisah:Integrasi API Express.js
Contoh lengkap mengintegrasikan pelacakan LLM ke dalam API Express.js:Apa yang Dilacak
Setiap panggilan API LLM secara otomatis mengirimkan peristiwa penggunaan ke Dodo Payments dengan struktur berikut:Bidang Peristiwa
Pengidentifikasi unik untuk peristiwa spesifik ini. Secara otomatis dihasilkan oleh SDK.Format:
llm_[timestamp]_[random]ID pelanggan yang Anda berikan saat membungkus klien. Digunakan untuk penagihan.
Nama peristiwa yang memicu meter Anda. Cocok dengan konfigurasi pelacak Anda.
Timestamp ISO 8601 saat peristiwa terjadi.
Penggunaan token dan data pelacakan tambahan:
inputTokens- Jumlah token input/prompt yang digunakanoutputTokens- Jumlah token output/kompleksi yang digunakan (termasuk token penalaran jika berlaku)totalTokens- Total token (input + output)model- Model LLM yang digunakan (misalnya, “gpt-4”)provider- Penyedia LLM (jika disertakan dalam metadata pembungkus)- Metadata kustom apa pun yang Anda berikan saat membungkus klien
Token Penalaran: Untuk model dengan kemampuan penalaran,
outputTokens secara otomatis menyertakan baik token penyelesaian maupun token penalaran.Meter Dodo Payments Anda menggunakan bidang
metadata (terutama inputTokens, outputTokens atau totalTokens) untuk menghitung penggunaan dan penagihan.