Langsung ke konten utama

Quick Start

Mulai dalam 2 menit dengan pelacakan token otomatis.

API Reference - Events Ingestion

Dokumentasi API lengkap untuk memasukkan event penggunaan.

API Reference - Meters

Pelajari cara membuat dan mengkonfigurasi meter untuk penagihan.

Usage-Based Billing Guide

Panduan komprehensif untuk penagihan berbasis penggunaan dengan meter.
Sangat cocok untuk aplikasi SaaS, chatbot AI, alat pembuatan konten, dan aplikasi bertenaga LLM apa pun yang memerlukan penagihan berbasis penggunaan.

Quick Start

Mulai dengan pelacakan token LLM otomatis hanya dalam 2 menit:
1

Install the SDK

Pasang Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Anda memerlukan dua kunci API:
  • Dodo Payments API Key: Dapatkan dari Dodo Payments Dashboard
  • LLM Provider API Key: Dari AI SDK, OpenAI, Anthropic, Groq, dll.
Simpan kunci API Anda dengan aman di variabel lingkungan. Jangan pernah commit ke kontrol versi.
3

Create a Meter in Dodo Payments

Sebelum melacak penggunaan, buat meter di dashboard Dodo Payments Anda:
  1. Masuk ke Dodo Payments Dashboard
  2. Navigasi ke Products → Meters
  3. Klik “Create Meter”
  4. Konfigurasikan meter Anda:
    • Meter Name: Pilih nama deskriptif (misalnya, “LLM Token Usage”)
    • Event Name: Atur identifier event unik (misalnya, llm.chat_completion)
    • Aggregation Type: Pilih sum untuk menjumlahkan jumlah token
    • Over Property: Pilih apa yang akan dilacak:
      • inputTokens - Lacak token input/prompt
      • outputTokens - Lacak token output/completion (termasuk token penalaran bila berlaku)
      • totalTokens - Lacak gabungan token input + output
Nama Event yang Anda tetapkan di sini harus cocok persis dengan yang Anda kirim ke SDK (peka huruf).
Untuk petunjuk mendetail, lihat Usage-Based Billing Guide.
4

Track Token Usage

Bungkus klien LLM Anda dan mulailah melacak secara otomatis:
Itu saja! Setiap panggilan API sekarang secara otomatis melacak penggunaan token dan mengirim event ke Dodo Payments untuk penagihan.

Konfigurasi

Konfigurasi Pelacak

Buat pelacak sekali saat aplikasi dimulai dengan parameter yang diperlukan ini:
apiKey
string
wajib
Kunci API Dodo Payments Anda. Dapatkan dari API Keys page.
environment
string
wajib
Mode lingkungan untuk tracker.
  • test_mode - Gunakan untuk pengembangan dan pengujian
  • live_mode - Gunakan untuk produksi
Selalu gunakan test_mode selama pengembangan agar tidak memengaruhi metrik produksi.
eventName
string
wajib
Nama event yang memicu meter Anda. Harus cocok persis dengan yang Anda konfigurasi di meter Dodo Payments (peka huruf).
Nama event ini menghubungkan penggunaan yang dilacak ke meter yang tepat untuk perhitungan penagihan.

Konfigurasi Pembungkus

Saat membungkus klien LLM Anda, berikan parameter ini:
client
object
wajib
Instansi klien LLM Anda (OpenAI, Anthropic, Groq, dll.).
customerId
string
wajib
Pengidentifikasi pelanggan unik untuk penagihan. Ini harus cocok dengan ID pelanggan Anda di Dodo Payments.
Gunakan ID pengguna atau ID pelanggan aplikasi Anda untuk memastikan penagihan akurat per pelanggan.
metadata
object
Data tambahan opsional untuk dilampirkan ke event 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:
Lacak penggunaan dengan Vercel AI SDK untuk dukungan LLM universal.
Metrik yang Dilacak:
  • inputTokensinputTokens
  • outputTokens + reasoningTokensoutputTokens
  • totalTokenstotalTokens
  • Nama model
Saat menggunakan model yang dapat melakukan penalaran melalui AI SDK (seperti Gemini 2.5 Flash milik Google dengan thinking mode), token penalaran secara otomatis termasuk dalam outputTokens untuk penagihan yang akurat.
Lacak penggunaan token di lebih dari 200 model melalui API terpadu OpenRouter.
Metrik yang Dilacak:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nama model
OpenRouter menyediakan akses ke model dari OpenAI, Anthropic, Google, Meta, dan banyak penyedia lainnya melalui satu API.
Lacak penggunaan token dari model GPT OpenAI secara otomatis.
Metrik yang Dilacak:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nama model
Lacak penggunaan token dari model Claude milik Anthropic.
Metrik yang Dilacak:
  • input_tokensinputTokens
  • output_tokensoutputTokens
  • Kalkulasi totalTokens
  • Nama model
Lacak inferensi LLM super cepat dengan Groq.
Metrik yang Dilacak:
  • prompt_tokensinputTokens
  • completion_tokensoutputTokens
  • total_tokenstotalTokens
  • Nama model
Lacak penggunaan token dari model Gemini Google melalui Google GenAI SDK.
Metrik yang Dilacak:
  • promptTokenCountinputTokens
  • candidatesTokenCount + thoughtsTokenCountoutputTokens
  • totalTokenCounttotalTokens
  • Versi model
Gemini Thinking Mode: Saat menggunakan model Gemini dengan kemampuan berpikir/menalar (seperti Gemini 2.5 Pro), SDK secara otomatis memasukkan thoughtsTokenCount (token penalaran) ke dalam outputTokens agar mencerminkan biaya komputasi penuh secara akurat.

Penggunaan Lanjutan

Beberapa Penyedia

Lacak penggunaan di berbagai penyedia LLM dengan pelacak terpisah:
Gunakan nama event berbeda untuk penyedia yang berbeda agar penggunaan terlacak secara terpisah di meter Anda.

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

event_id
string
Pengidentifikasi unik untuk event ini. Dibuat otomatis oleh SDK.Format: llm_[timestamp]_[random]
customer_id
string
ID pelanggan yang Anda berikan saat membungkus klien. Digunakan untuk penagihan.
event_name
string
Nama event yang memicu meter Anda. Sesuai dengan konfigurasi tracker Anda.
timestamp
string
Timestamp ISO 8601 ketika event terjadi.
metadata
object
Penggunaan token dan data pelacakan tambahan:
  • inputTokens - Jumlah token input/prompt yang digunakan
  • outputTokens - Jumlah token output/completion yang digunakan (termasuk token penalaran bila berlaku)
  • totalTokens - Total token (input + output)
  • model - Model LLM yang digunakan (misalnya, “gpt-4”)
  • provider - Penyedia LLM (jika disertakan dalam metadata wrapper)
  • Metadata khusus apa pun yang Anda berikan saat membungkus klien
Token Penalaran: Untuk model dengan kemampuan penalaran, outputTokens secara otomatis mencakup token completion dan token penalaran.
Meter Dodo Payments Anda menggunakan bidang metadata (terutama inputTokens, outputTokens atau totalTokens) untuk menghitung penggunaan dan penagihan.

Terakhir diubah pada 1 April 2026