कोटा और उपयोग
GVR उपयोगकर्ता खाते के remainingRequests मान के ज़रिए हर API कुंजी के अनुरोध उपयोग को ट्रैक करता है।
हर ऑपरेशन की अनुरोध लागत
प्रोसेसिंग सफल होने पर कोटा घटता है। सफल unknown लिंग परिणाम भी कोटा खर्च करता है।
| ऑपरेशन | खर्च किया गया कोटा |
|---|---|
| मानक वॉइस फ़ाइल से लिंग विश्लेषण | 1 अनुरोध |
| मानक URL से लिंग विश्लेषण | 1 अनुरोध |
| वॉइस से लिंग V2 (बेहतर भाषण-पहचान विश्लेषण) | 1 अनुरोध |
| वॉइस से लिंग V3 (उन्नत वक्ता-आधारित विश्लेषण) | 2 अनुरोध |
| वॉइस आयु, नकली वॉइस, भाषण भावना, ऑडियो गुणवत्ता, वक्ता सत्यापन, इमेज या एक नाम का विश्लेषण | हर सफल API कॉल पर 1 अनुरोध |
| CSV सत्यापन | कोई अनुरोध नहीं; यह जाँचता है कि सभी पंक्तियों को प्रोसेस करने के लिए पर्याप्त कोटा है या नहीं |
| CSV प्रोसेसिंग | हर प्रोसेस की गई CSV पंक्ति पर 1 अनुरोध |
CSV API
CSV प्रोसेसिंग अलग है, क्योंकि एक फ़ाइल में कई पंक्तियाँ हो सकती हैं। API प्रोसेसिंग से पहले पंक्तियों की संख्या जाँचती है और हर पंक्ति के लिए एक अनुरोध खर्च करती है।
यदि फ़ाइल में कुंजी के शेष अनुरोधों से अधिक पंक्तियाँ हों, तो 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 सत्यापित करें।