⚡ नवीन — Kimi K3 आता लाइव: तुमची Moonshot की जोडा →
दस्तऐवज

वापर, क्रियाकलाप & रँकिंग

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, toYYYY-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 }