मुख्य कंटेंट तक स्किप करें

कोटा और उपयोग

GVR उपयोगकर्ता खाते के remainingRequests मान के ज़रिए हर API कुंजी के अनुरोध उपयोग को ट्रैक करता है।

एकल अनुरोध वाली API​

अधिकांश API कॉल सफलतापूर्वक प्रोसेस होने पर एक अनुरोध खर्च करती हैं।

उदाहरण:

  • वॉइस फ़ाइल से लिंग पहचान अनुरोध
  • वॉइस से आयु अनुमान अनुरोध
  • नकली वॉइस पहचान अनुरोध
  • इमेज से लिंग पहचान अनुरोध
  • इमेज से आयु अनुमान अनुरोध
  • नाम संबंधी एकल जानकारी अनुरोध

CSV API​

CSV प्रोसेसिंग अलग है क्योंकि एक फ़ाइल में कई पंक्तियाँ हो सकती हैं। CSV प्रोसेसिंग पंक्तियों की संख्या जाँचती है और हर प्रोसेस की गई पंक्ति के लिए एक अनुरोध खर्च कर सकती है।

यदि फ़ाइल में कुंजी के शेष अनुरोधों से अधिक पंक्तियाँ हों, तो API CSV प्रोसेस करने से पहले अनुरोध अस्वीकार कर देती है।

प्रतिक्रिया मेटाडेटा​

कई सफल API प्रतिक्रियाओं में अपडेट किया गया कोटा शामिल होता है:

{
  "remainingRequests": 2999
}

इस मान का उपयोग ऐप्लिकेशन में उपयोग दिखाने या कोटा समाप्त होने से पहले अपग्रेड सूचना देने के लिए करें।

कोटा संबंधी त्रुटियाँ​

फ़ाइल और CSV एंडपॉइंट अनुरोध सीमा की संरचित प्रतिक्रिया दे सकते हैं:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

नाम संबंधी एकल एंडपॉइंट यह प्रतिक्रिया दे सकते हैं:

{
  "error": "Insufficient remaining requests"
}

उपयोगी सुझाव​

  • API कॉल करने से पहले ज़रूरी फ़ील्ड सत्यापित करें।
  • सत्यापन त्रुटियों पर बार-बार अनुरोध भेजने से बचें।
  • हर API प्रतिक्रिया के बाद remainingRequests को कोटे का सही मान मानें।
  • बड़े CSV प्रोसेसिंग कार्य से पहले CSV सत्यापित करें।