مین مواد پر جائیں

کوٹے اور استعمال

GVR ہر API key کے استعمال کو صارف کے اکاؤنٹ کی remainingRequests قدر کے ذریعے ٹریک کرتا ہے۔

ایک درخواست والی APIs​

زیادہ تر API کال کامیاب پراسیسنگ کے بعد ایک درخواست استعمال کرتی ہیں۔

مثالیں:

  • آواز سے جنس کی فائل درخواست
  • آواز سے عمر کی درخواست
  • مصنوعی آواز کی شناخت کی درخواست
  • تصویر سے جنس کی درخواست
  • تصویر سے عمر کی درخواست
  • نام سے متعلق معلومات کی انفرادی درخواست

CSV APIs​

CSV پراسیسنگ مختلف ہے کیونکہ ایک فائل میں کئی قطاریں ہو سکتی ہیں۔ CSV پراسیسنگ قطاروں کی تعداد جانچتی ہے اور ہر پراسیس شدہ قطار کے لیے ایک درخواست استعمال کر سکتی ہے۔

اگر فائل کی قطاریں 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 کے بڑے پراسیسنگ کام سے پہلے فائل کی توثیق کریں۔