दस्तावेज़

उपयोग, गतिविधि & रैंकिंग

BharatRouter आपके संगठन की खपत को दो तरीकों से प्रदर्शित करता है: हल्के usageकाउंटर और प्रति-अनुरोध ड्रिल-डाउन वाली एक बेहतर activity फ़ीड। एक सार्वजनिकrankings एंडपॉइंट भी है जो प्लेटफ़ॉर्म-व्यापी सबसे अधिक उपयोग किए जाने वाले मॉडल दिखाता है। संगठन की सभी तारीख़ की गणना IST (Asia/Kolkata) में होती है।

उपयोग

एंडपॉइंट	रिटर्न
`GET /me/usage`	प्रति key अनुरोध और टोकन, आज और पिछले 30 दिनों में, साथ ही संगठन का कुल योग।
`GET /me/usage/daily`	पिछले 30 IST दिनों के लिए एक दिन × model श्रृंखला — डैशबोर्ड चार्ट को शक्ति प्रदान करती है।

गतिविधि

GET /me/activity एक तिथि सीमा पर खर्च और मात्रा के कुल योग को, फ़िल्टर के साथ, रिटर्न करता है। लागत वह है जो वास्तव में डेबिट की गई थी (परीक्षण, BYOK और विफल अनुरोधों को ₹0 माना जाता है)।

क्वेरी	अर्थ
`from`, `to`	`YYYY-MM-DD` (IST)। डिफ़ॉल्ट रूप से पिछले 30 दिन; अधिकतम अवधि 366 दिन।
`model`, `key_id`	वैकल्पिक फ़िल्टर।

प्रतिक्रिया में एक दिन × model days श्रृंखला, top_models औरtop_keys, प्रत्येक model के लिए प्रति-provider लागत विभाजन (model_providers, जो फॉलबैक में महसूस की गई लागत दिखाता है), संगठन का totals (अनुरोध, टोकन, लागत, त्रुटियाँ, BYOK अनुरोध), और फ़िल्टर ड्रॉपडाउन के लिए विशिष्ट model/key सूचियाँ शामिल हैं।

प्रति-अनुरोध ड्रिल-डाउन

GET /me/activity/events व्यक्तिगत अनुरोधों को सूचीबद्ध करता है, सबसे नए पहले, keyset पेजिनेशन के साथ। प्रत्येक पंक्ति में model, उसे प्रदान करने वाला provider, स्थिति, latency, टोकन, लागत, और key का नाम होता है। before=<id> और limit (≤200) के साथ पेज करें; प्रतिक्रिया अगले पेज के लिए next_before रिटर्न करती है।

GET /me/activity/events?from=2026-06-01&to=2026-06-13&limit=50
→ { "events": [ { "at": "...", "model": "gemma-4-e4b-it", "provider": "krutrim",
                  "status": 200, "latency_ms": 740, "tokens": 312,
                  "cost_inr": 0.0061, "key_name": "prod" }, ... ],
    "next_before": 80421 }

रैंकिंग (सार्वजनिक, कोई auth नहीं)

GET /v1/rankings 7-दिन और 30-दिन की अवधि में टोकन वॉल्यूम के अनुसार सबसे अधिक उपयोग किए जाने वाले कैटलॉग मॉडल को रिटर्न करता है — गुमनाम और प्लेटफ़ॉर्म-व्यापी, कभी भी प्रति-ग्राहक नहीं। केवल-BYOK model id बाहर रखे जाते हैं; परिणाम कुछ मिनटों के लिए कैशे किया जाता है।

curl -s https://api.bharatrouter.com/v1/rankings | jq '.windows["7d"][0]'
→ { "model": "gemma-4-e4b-it", "requests": 18342, "tokens": 9120553 }

उपयोग, गतिविधि &amp; रैंकिंग