Langsung ke konten utama
Meter mengubah event mentah menjadi jumlah yang dapat ditagih. Mereka menyaring event dan menerapkan fungsi agregasi (Count, Sum, Max, Last) untuk menghitung pemakaian per pelanggan.
Antarmuka pembuatan meter yang menunjukkan nama event, jenis agregasi, dan opsi penyaringan

​
Sumber Daya API

​
Membuat Meter

1

Basic Information

​
Meter Name
string
wajib
Nama deskriptif (misalnya, “API Requests”, “Token Usage”)
​
Event Name
string
wajib
Nama event yang tepat untuk dicocokkan (sensitif terhadap huruf besar/kecil). Contoh: api.call, image.generated
2

Aggregation

​
Aggregation Type
string
wajib
Pilih bagaimana event diagregasi:
  • Count: Jumlah total event (panggilan API, unggahan)
  • Sum: Menjumlahkan nilai numerik (token, byte)
  • Max: Nilai tertinggi dalam periode (pengguna puncak)
  • Last: Nilai terbaru
​
Over Property
string
Kunci metadata untuk diagregasi (wajib untuk semua jenis kecuali Count). Contoh: tokens, bytes, duration_ms
​
Measurement Unit
string
wajib
Label satuan untuk faktur. Contoh: calls, tokens, GB, hours
3

Filtering (Optional)

Penyaringan event
Tambahkan kondisi untuk menyaring peristiwa mana yang dihitung:
  • Logika DAN: Semua kondisi harus cocok
  • Logika ATAU: Kondisi mana pun dapat cocok
Pembanding: sama dengan, tidak sama dengan, lebih besar dari, kurang dari, mengandungAktifkan penyaringan, pilih logika, tambahkan kondisi dengan kunci properti, pembanding, dan nilai.
4

Create

Tinjau konfigurasi dan klik Create Meter.

​
Melihat Analitik

Analitik meter
Dasbor meter Anda menunjukkan:
  • Ikhtisar: Total penggunaan dan grafik penggunaan
  • Peristiwa: Peristiwa individu yang diterima
  • Pelanggan: Penggunaan dan biaya per pelanggan

​
Penagihan dalam Kredit Alih-alih Mata Uang

Secara default, meter mengenakan biaya pelanggan per unit dalam dolar (atau mata uang yang Anda konfigurasikan). Anda bisa mengonfigurasi meter untuk memotong dari saldo kredit - jadi penggunaan mengonsumsi kredit alih-alih menghasilkan biaya moneter.
Pengurangan berbasis kredit memerlukan sebuah Hak Kredit yang terpasang pada produk yang sama. Buat kredit Anda terlebih dahulu, lalu tautkan ke meter.

​
Kapan Menggunakan Pengurangan Berbasis Kredit

ScenarioStandard (currency)Credit-based
Penetapan harga per unit sederhana ($0,01/panggilan)✅ Paling tepatBeban tambahan yang tidak perlu
Paket kredit prabayar (beli 10K token, gunakan seiring waktu)❌ Tidak bisa diekspresikan✅ Paling tepat
Penggunaan bundel dengan langganan (paket Pro mencakup 100K panggilan)Mungkin lewat ambang bebas✅ Lebih baik - kredit digulirkan, kedaluwarsa, tampil di portal
Produk multi-meter berbagi kumpulan kredit❌ Setiap meter menagih secara terpisah✅ Semua meter memotong dari satu saldo

​
Mengonfigurasi Meter agar Memotong Kredit

1

Create a Credit Entitlement

Pertama, buat kredit di Products → Credits. Tentukan unit (misal, “API Calls”, “Tokens”), presisi, dan pengaturan siklus hidup (kedaluwarsa, pengguliran, kelebihan).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'

Alihkan Bill usage in Credits di konfigurasi meter. Ini akan menampilkan pengaturan kredit:
Konfigurasi meter dengan tombol Bill usage in Credits diaktifkan
​
Credit Entitlement
string
wajib
Pilih hak kredit mana yang harus dipotong oleh meter ini.
​
Meter units per credit
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

Set the Free Threshold

Ambang Free Threshold masih berlaku - peristiwa di bawah ambang ini tidak memotong kredit.Contoh: Dengan ambang bebas 1.000 dan meter-units-per-credit 1:
  • Pelanggan menggunakan 2.500 panggilan API
  • 1.000 pertama gratis
  • Sisa 1.500 memotong 1.500 kredit dari saldo mereka

​
Bagaimana Pengurangan Kredit Bekerja

Setelah dikonfigurasi, pipeline pengurangan berjalan secara otomatis:
  1. Events arrive - Aplikasi Anda mengirimkan peristiwa penggunaan melalui Event Ingestion API
  2. Meter aggregates - Peristiwa digabungkan sesuai konfigurasi meter Anda (Count, Sum, Max, Last)
  3. Background worker processes - Setiap menit, seorang pekerja mengambil peristiwa baru sejak checkpoint terakhir
  4. Credits are deducted - Penggunaan yang telah digabungkan dikonversi menjadi kredit menggunakan tarif meter_units_per_credit dan dipotong menggunakan penyusunan FIFO (hak kredit tertua dikonsumsi lebih dulu)
  5. Overage tracked - Jika saldo mencapai nol dan overage diaktifkan, penggunaan berlanjut dan overage ditangani sesuai perilaku yang dikonfigurasi (maafkan saat reset, ditagihkan di faktur berikutnya, atau dibawa maju sebagai defisit)
Pengurangan kredit berjalan secara asinkron (setiap ~1 menit). Mungkin ada jeda singkat antara ingesting peristiwa dan pemotongan saldo. Rancang aplikasi Anda untuk menangani jeda ini - jangan bergantung pada pemeriksaan saldo waktu nyata untuk kontrol akses pada permintaan individual.

​
Banyak Meter, Satu Kumpulan Kredit

Anda dapat menautkan beberapa meter pada produk yang sama ke hak kredit yang sama. Semua meter memotong dari 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 peristiwa harus cocok persis (sensitif huruf besar-kecil)
  • Periksa agar filter meter tidak mengecualikan peristiwa
  • Pastikan ID pelanggan ada
  • Nonaktifkan filter sementara untuk menguji
  • Pastikan Over Property cocok persis dengan kunci metadata
  • Gunakan angka, bukan string: tokens: 150 bukan "150"
  • Sertakan properti yang diperlukan dalam semua peristiwa
  • Cocokkan huruf besar-kecil secara tepat
  • Gunakan operator yang tepat untuk tipe data
  • Pastikan peristiwa menyertakan properti yang difilter
  • Periksa tab Events untuk menghitung peristiwa yang sebenarnya diterima
  • Verifikasi jenis agregasi (Count vs Sum)
  • Pastikan nilainya numerik untuk Sum/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.