کوٹے اور استعمال
GVR ہر API key کے استعمال کو صارف کے اکاؤنٹ کی remainingRequests قدر کے ذریعے ٹریک کرتا ہے۔
ہر آپریشن کی درخواست لاگت
پراسیسنگ کامیاب ہونے پر کوٹہ منہا ہوتا ہے۔ کامیاب unknown جنس کا نتیجہ بھی کوٹہ استعمال کرتا ہے۔
| آپریشن | استعمال شدہ کوٹہ |
|---|---|
| معیاری فائل سے آواز کی جنس کا تجزیہ | 1 درخواست |
| معیاری URL سے آواز کی جنس کا تجزیہ | 1 درخواست |
| آواز سے جنس V2 (تقریر کی شناخت کے ساتھ بہتر تجزیہ) | 1 درخواست |
| آواز سے جنس V3 (بولنے والے کا جدید تجزیہ) | 2 درخواستیں |
| آواز سے عمر، مصنوعی آواز، تقریر کے جذبات، آڈیو معیار، بولنے والے کی تصدیق، تصویر یا ایک نام کا تجزیہ | ہر کامیاب API کال پر 1 درخواست |
| CSV کی توثیق | کوئی درخواست نہیں؛ یہ جانچتا ہے کہ تمام قطاروں کی پراسیسنگ کے لیے کافی کوٹہ ہے یا نہیں |
| CSV پراسیسنگ | ہر پراسیس شدہ CSV قطار پر 1 درخواست |
CSV APIs
CSV پراسیسنگ مختلف ہے کیونکہ ایک فائل میں کئی قطاریں ہو سکتی ہیں۔ API پراسیسنگ سے پہلے قطاروں کی تعداد جانچتی ہے اور ہر قطار پر ایک درخواست استعمال کرتی ہے۔
اگر فائل کی قطاریں key کی باقی درخواستوں سے زیادہ ہوں تو 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 کے بڑے پراسیسنگ کام سے پہلے فائل کی توثیق کریں۔