मुख्य सामग्री पर जाएं
Meters कच्ची घटनाओं को बिल योग्य मात्राओं में बदलते हैं। वे घटनाओं को फ़िल्टर करते हैं और प्रति ग्राहक उपयोग की गणना करने के लिए aggregation functions (Count, Sum, Max, Last) लागू करते हैं।
मीटर निर्माण इंटरफ़ेस जिसमें इवेंट नाम, सारणीकरण प्रकार और फ़िल्टरिंग विकल्प दर्शाए गए हैं

API संसाधन

Create Meter

API के माध्यम से प्रोग्रामेटिक रूप से मीटर बनाएं।

List Meters

अपने खाते में सभी मीटर प्राप्त करें।

Get Meter

ID द्वारा किसी विशिष्ट मीटर के विवरण प्राप्त करें।

Archive Meter

उपयोग ट्रैकिंग बंद करने के लिए मीटर को आर्काइव करें।

Unarchive Meter

ट्रैकिंग फिर से शुरू करने के लिए एक आर्काइव किए गए मीटर को पुनर्स्थापित करें।

मीटर बनाना

1

Basic Information

string
आवश्यक
मीटर के लिए एक वर्णनात्मक नाम (जैसे, “API Requests”, “Token Usage”)।
string
आवश्यक
मिलान करने के लिए सटीक event name (case-sensitive)। उदाहरण: api.call, image.generated।
2

Aggregation

string
आवश्यक
निर्धारित करें कि इवेंट्स को कैसे एग्रीगेट किया जाता है:
  • Count: घटनाओं की कुल संख्या (API calls, uploads)
  • Sum: संख्यात्मक मानों का योग (tokens, bytes)
  • Max: अवधि में सबसे अधिक मान (peak users)
  • Last: सबसे हाल का मान
string
वह metadata key जिसे aggregate करना है (Sum, Max और Last के लिए आवश्यक)। उदाहरण: tokens, bytes, duration_ms।
string
आवश्यक
Invoices और reports के लिए unit label। उदाहरण: calls, tokens, GB, hours।
3

Filtering (Optional)

AND/OR logic और comparison operators वाला event filtering interface
उन घटनाओं को फ़िल्टर करने के लिए शर्तें जोड़ें जिन्हें गिना जाएगा:
  • AND लॉजिक: सभी शर्तें मेल खानी चाहिए
  • OR लॉजिक: कोई भी शर्त मेल खा सकती है
उपलब्ध comparators: equals, not equals, greater than, greater than or equals, less than, less than or equals, contains, does not contain।Filtering enable करें, अपना logic चुनें, फिर property key, comparator और value के साथ conditions जोड़ें।
4

Create

अपने configuration की समीक्षा करें और Create Meter पर क्लिक करें।

विश्लेषण देखना

usage overview, events और customer data दिखाने वाला meter analytics dashboard
आपका meter dashboard दिखाता है:
  • Overview: समय के साथ कुल usage और usage trends
  • Events: प्राप्त हुई individual events और उनका metadata
  • Customers: प्रति-ग्राहक usage totals और charges

मुद्रा के बजाय क्रेडिट में बिलिंग

डिफ़ॉल्ट रूप से, meters ग्राहकों से dollars (या आपके configured currency) में प्रति-unit शुल्क लेते हैं। इसके बजाय, आप meter को ग्राहक के credit balance से कटौती करने के लिए configure कर सकते हैं, ताकि usage से monetary charge उत्पन्न होने के बजाय credits खर्च हों।
Credit-based deduction के लिए उसी product से जुड़ा हुआ Credit Entitlement आवश्यक है। पहले credit entitlement बनाएँ, फिर उसे meter से link करें।

क्रेडिट-आधारित कटौती कब उपयोग करें

क्रेडिट घटाने के लिए मीटर को कॉन्फ़िगर करना

1

Create a Credit Entitlement

सबसे पहले, Products → Credits में credit entitlement बनाएँ। unit (जैसे, “API Calls”, “Tokens”), precision और lifecycle settings (expiry, rollover, overage) निर्धारित करें।विस्तृत निर्देशों के लिए Credit-Based Billing guide देखें।
2

Create or Edit a Usage-Based Product

अपने उपयोग-आधारित उत्पाद पर जाएं और Meter कॉन्फ़िगरेशन सेक्शन खोलें।
3

Add a Meter

मीटर संलग्न करने के लिए + बटन क्लिक करें। जैसा कि हमेशा होता है, इवेंट का नाम, समेकन प्रकार और मापन इकाई कॉन्फ़िगर करें।
4

Enable 'Bill Usage in Credits'

Credit settings दिखाने के लिए meter configuration में Bill usage in Credits को on करें:
क्रेडिट टॉगल में बिल उपयोग के साथ मीटर कॉन्फ़िगरेशन सक्षम

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

string
आवश्यक
चुनें कि यह meter किस credit entitlement से कटौती करेगा।
number
आवश्यक
1 क्रेडिट घटाने के लिए आवश्यक उपयोग इकाइयों की संख्या। उदाहरण के लिए:
  • 1 = प्रत्येक मीटर इवेंट 1 क्रेडिट घटाता है
  • 100 = 100 मीटर इवेंट 1 क्रेडिट घटाते हैं
  • 1000 = 1,000 API कॉल 1 क्रेडिट का उपभोग करते हैं
5

Free Threshold and Credits

Free Threshold उन meters पर लागू होता है जिनका billing money में होता है, credits में billed meters पर नहीं। जब कोई meter credits में bill करता है, तो प्रत्येक unit credit deduction में गिनी जाती है।Example: meter-units-per-credit 1 होने पर, 2,500 API calls करने वाले ग्राहक से 2,500 credits काटे जाते हैं।

क्रेडिट कटौती कैसे काम करती है

एक बार कॉन्फ़िगर होने पर, कटौती पाइपलाइन स्वतः चलती है:
  1. Events arrive — आपका application Event Ingestion API के माध्यम से usage events भेजता है।
  2. Meter aggregates — events को आपके meter configuration (Count, Sum, Max, Last) के अनुसार aggregate किया जाता है।
  3. Background worker processes — हर मिनट, एक worker पिछले checkpoint के बाद से प्राप्त नई events fetch करता है।
  4. Credits are deducted — Aggregated usage को meter_units_per_credit rate का उपयोग करके credits में बदला जाता है और FIFO ordering (सबसे पहले समाप्त होने वाले grants पहले consume होते हैं) के अनुसार काटा जाता है।
  5. Overage tracked — यदि balance शून्य हो जाता है, तो आगे का usage overage के रूप में record किया जाता है और configured behavior (reset पर forgiven, next invoice पर billed, या deficit के रूप में carried forward) के अनुसार संभाला जाता है। Dodo Payments balance समाप्त होने पर usage को block नहीं करता। शून्य balance पर access रोकने के लिए अपने application में balance check करें।
Credit deduction asynchronous रूप से (हर ~1 मिनट में) चलता है। Event ingestion और balance deduction के बीच थोड़ी देरी हो सकती है। इस देरी को संभालने के लिए अपना application design करें और individual requests पर access control के लिए real-time balance checks पर निर्भर न रहें।

कई मीटर, एक क्रेडिट पूल

आप एक ही product पर कई meters को उसी credit entitlement से link कर सकते हैं। सभी meters एक shared balance से कटौती करते हैं। Example: दो meters वाला एक AI platform:
  • text.generation — 1,000 tokens पर 1 credit
  • image.generation — प्रति image 10 credits
दोनों एक ही “AI Credits” पूल से घटाते हैं। ग्राहक अपने पोर्टल में एक एकीकृत बैलेंस देखते हैं।
विभिन्न मीटरों में meter_units_per_credit दरों का उपयोग करके सापेक्ष लागत व्यक्त करें। महंगे ऑपरेशन (इमेज जनरेशन) सस्ते ऑपरेशन (टेक्स्ट कम्प्लीशन) की तुलना में प्रति क्रेडिट कम मीटर यूनिट लेते हैं।

List Customer Ledger

एक ग्राहक के लिए पूर्ण क्रेडिट कटौती इतिहास देखें।

Get Customer Balance

API के माध्यम से ग्राहक का वर्तमान क्रेडिट बैलेंस जांचें।

समस्या निवारण

  • Event name का match बिल्कुल सटीक होना चाहिए (case-sensitive)
  • जाँचें कि meter filters events को exclude नहीं कर रहे हैं
  • सत्यापित करें कि customer IDs आपके account में मौजूद हैं
  • परीक्षण के लिए filters को अस्थायी रूप से disable करें
  • सत्यापित करें कि Over Property metadata key से बिल्कुल मेल खाता है
  • strings के बजाय numbers का उपयोग करें: tokens: 150, tokens: "150" नहीं
  • सभी events में आवश्यक properties शामिल करें
  • Case बिल्कुल सटीक रखें
  • Data type के लिए सही operators का उपयोग करें
  • सुनिश्चित करें कि events में filtered properties शामिल हैं
  • प्राप्त हुई actual events की संख्या जानने के लिए Events tab जाँचें
  • Aggregation type (Count बनाम Sum) सत्यापित करें
  • सुनिश्चित करें कि Sum और Max के लिए values numeric हैं

अगले चरण

Send Events

अपने एप्लिकेशन से अपने मीटरों को उपयोग इवेंट भेजना शुरू करें।

View Blueprints

सामान्य उपयोग मामलों के लिए रेडी-मेड मीटर कॉन्फ़िगरेशन का उपयोग करें।
अंतिम संशोधन 26 सितंबर 2026