Langsung ke konten utama
Meter mengonversi event mentah menjadi kuantitas yang dapat ditagihkan. Meter memfilter event dan menerapkan fungsi agregasi (Count, Sum, Max, Last) untuk menghitung penggunaan per pelanggan.
Antarmuka pembuatan meteran yang menunjukkan nama acara, jenis agregasi, dan opsi pemfilteran

Sumber Daya API

Create Meter

Buat meter secara program melalui API.

List Meters

Ambil semua meter dalam akun Anda.

Get Meter

Ambil detail untuk meter tertentu berdasarkan ID.

Archive Meter

Arsipkan meter untuk berhenti melacak pemakaian.

Unarchive Meter

Pulihkan meter yang diarsipkan untuk melanjutkan pelacakan.

Membuat Meter

1

Basic Information

string
wajib
Nama deskriptif untuk meter (misalnya, “API Requests”, “Token Usage”).
string
wajib
Nama event persis yang akan dicocokkan (peka huruf besar-kecil). Contoh: api.call, image.generated.
2

Aggregation

string
wajib
Pilih bagaimana event diagregasi:
  • Count: Jumlah total event (panggilan API, upload)
  • Sum: Jumlah nilai numerik (token, byte)
  • Max: Nilai tertinggi dalam periode tersebut (pengguna puncak)
  • Last: Nilai terbaru
string
Kunci metadata yang akan diagregasikan (wajib untuk Sum, Max, dan Last). Contoh: tokens, bytes, duration_ms.
string
wajib
Label unit untuk invoice dan laporan. Contoh: calls, tokens, GB, hours.
3

Filtering (Optional)

Antarmuka pemfilteran event dengan logika AND/OR dan operator perbandingan
Tambahkan kondisi untuk menyaring peristiwa mana yang dihitung:
  • Logika DAN: Semua kondisi harus cocok
  • Logika ATAU: Kondisi mana pun dapat cocok
Komparator yang tersedia: sama dengan, tidak sama dengan, lebih besar dari, lebih besar dari atau sama dengan, kurang dari, kurang dari atau sama dengan, berisi, tidak berisi.Aktifkan pemfilteran, pilih logika Anda, lalu tambahkan kondisi dengan kunci properti, komparator, dan nilai.
4

Create

Tinjau konfigurasi Anda dan klik Create Meter.

Melihat Analitik

Dasbor analitik meter yang menampilkan ringkasan penggunaan, event, dan data pelanggan
Dasbor meter Anda menampilkan:
  • Overview: Total penggunaan dan tren penggunaan dari waktu ke waktu
  • Events: Event individual yang diterima beserta metadatanya
  • Customers: Total penggunaan dan biaya per pelanggan

Penagihan dalam Kredit Alih-alih Mata Uang

Secara default, meter menagih pelanggan per unit dalam dolar (atau mata uang yang Anda konfigurasi). Anda juga dapat mengonfigurasi meter untuk mengurangi saldo kredit pelanggan, sehingga penggunaan mengonsumsi kredit alih-alih menghasilkan biaya moneter.
Pengurangan berbasis kredit memerlukan Credit Entitlement yang terpasang pada produk yang sama. Buat credit entitlement terlebih dahulu, lalu tautkan ke meter.

Kapan Menggunakan Pengurangan Berbasis Kredit

Mengonfigurasi Meter agar Memotong Kredit

1

Create a Credit Entitlement

Pertama, buat credit entitlement di Products → Credits. Tentukan unit (misalnya, “API Calls”, “Tokens”), presisi, dan pengaturan lifecycle (kedaluwarsa, rollover, overage).Lihat panduan Penagihan Berbasis Kredit untuk petunjuk rinci.
2

Create or Edit a Usage-Based Product

Buka produk berbasis penggunaan Anda dan buka bagian konfigurasi Meter.
3

Add a Meter

Klik tombol + untuk melampirkan meter. Konfigurasikan nama acara, jenis agregasi, dan unit pengukuran seperti biasa.
4

Enable 'Bill Usage in Credits'

Aktifkan Bill usage in Credits pada konfigurasi meter untuk menampilkan pengaturan kredit:
Konfigurasi meteran dengan toggle Penggunaan Tagihan di Kredit diaktifkan

Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.

string
wajib
Pilih credit entitlement yang akan menjadi sumber pengurangan meter ini.
number
wajib
Jumlah unit penggunaan yang diperlukan agar memotong 1 kredit. Misalnya:
  • 1 = setiap peristiwa meter memotong 1 kredit
  • 100 = 100 peristiwa meter memotong 1 kredit
  • 1000 = 1.000 panggilan API mengonsumsi 1 kredit
5

Free Threshold and Credits

Free Threshold berlaku untuk meter yang ditagihkan dalam bentuk uang, bukan meter yang ditagihkan dalam kredit. Saat meter menagih dalam kredit, setiap unit dihitung sebagai pengurangan kredit.Contoh: Dengan meter-units-per-credit sebesar 1, pelanggan yang melakukan 2.500 panggilan API akan dikurangi 2.500 kredit.

Bagaimana Pengurangan Kredit Bekerja

Setelah dikonfigurasi, pipeline pengurangan berjalan secara otomatis:
  1. Event tiba — Aplikasi Anda mengirim event penggunaan melalui Event Ingestion API.
  2. Meter melakukan agregasi — Event diagregasikan sesuai konfigurasi meter Anda (Count, Sum, Max, Last).
  3. Worker latar belakang memproses — Setiap menit, worker mengambil event baru sejak checkpoint terakhir.
  4. Kredit dikurangi — Penggunaan yang telah diagregasikan dikonversi menjadi kredit menggunakan rate meter_units_per_credit dan dikurangi menggunakan urutan FIFO (grant yang paling cepat kedaluwarsa digunakan terlebih dahulu).
  5. Overage dilacak — Jika saldo mencapai nol, penggunaan selanjutnya dicatat sebagai overage dan ditangani sesuai perilaku yang dikonfigurasi (dimaafkan saat reset, ditagihkan pada invoice berikutnya, atau dibawa ke depan sebagai defisit). Dodo Payments tidak memblokir penggunaan saat saldo habis. Untuk menghentikan akses saat saldo nol, periksa saldo di aplikasi Anda.
Pengurangan kredit berjalan secara asinkron (sekitar setiap ~1 menit). Mungkin terdapat sedikit jeda antara penerimaan event dan pengurangan saldo. Rancang aplikasi Anda untuk menangani jeda ini dan jangan mengandalkan pemeriksaan saldo real-time untuk kontrol akses pada setiap request.

Banyak Meter, Satu Kumpulan Kredit

Anda dapat menautkan beberapa meter pada produk yang sama ke credit entitlement yang sama. Semua meter mengurangi satu saldo bersama. Contoh: Platform AI dengan dua meter:
  • text.generation — 1 kredit per 1.000 token
  • image.generation — 10 kredit per gambar
Keduanya memotong dari kumpulan “AI Credits” yang sama. Pelanggan melihat satu saldo terpadu di portal mereka.
Gunakan tarif meter_units_per_credit berbeda antar meter untuk menyatakan biaya relatif. Operasi mahal (generasi gambar) membutuhkan lebih sedikit unit meter per kredit dibanding yang murah (penyelesaian teks).

List Customer Ledger

Lihat riwayat pengurangan kredit lengkap untuk pelanggan.

Get Customer Balance

Periksa saldo kredit saat ini pelanggan melalui API.

Pemecahan Masalah

  • Nama event harus sama persis (peka huruf besar-kecil)
  • Periksa apakah filter meter mengecualikan event
  • Pastikan ID pelanggan ada di akun Anda
  • Nonaktifkan filter sementara untuk melakukan pengujian
  • Pastikan Over Property sama persis dengan kunci metadata
  • Gunakan angka, bukan string: tokens: 150 bukan tokens: "150"
  • Sertakan properti wajib dalam semua event
  • Cocokkan huruf besar-kecil secara persis
  • Gunakan operator yang sesuai untuk tipe data
  • Pastikan event menyertakan properti yang difilter
  • Periksa tab Events untuk menghitung event aktual yang diterima
  • Verifikasi tipe agregasi (Count vs Sum)
  • Pastikan nilai berupa angka untuk Sum dan Max

Langkah Berikutnya

Send Events

Mulai kirim peristiwa penggunaan dari aplikasi Anda ke meter Anda.

View Blueprints

Gunakan konfigurasi meter siap pakai untuk kasus penggunaan umum.
Terakhir diubah pada 26 September 2026