স্কিপ করে মূল কন্টেন্ট এ যান

কোটা ও ব্যবহার

GVR প্রতিটি API কী-র অনুরোধ ব্যবহার অ্যাকাউন্টের remainingRequests মান দিয়ে হিসাব করে।

একক অনুরোধের 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 ফাইল যাচাই করুন।