কোটা ও ব্যবহার
GVR প্রতিটি API কী-র অনুরোধ ব্যবহার অ্যাকাউন্টের remainingRequests মান দিয়ে হিসাব করে।
কাজ অনুযায়ী অনুরোধের খরচ
প্রক্রিয়াকরণ সফল হলে কোটা কাটা হয়। সফল unknown লিঙ্গ ফলাফলও কোটা ব্যবহার করে।
| কাজ | ব্যবহৃত কোটা |
|---|---|
| মানক ফাইল থেকে ভয়েসের লিঙ্গ বিশ্লেষণ | ১টি অনুরোধ |
| মানক URL থেকে ভয়েসের লিঙ্গ বিশ্লেষণ | ১টি অনুরোধ |
| ভয়েস থেকে লিঙ্গ V2 (কথা শনাক্তকরণসহ উন্নত বিশ্লেষণ) | ১টি অনুরোধ |
| ভয়েস থেকে লিঙ্গ V3 (উন্নত বক্তা-ভিত্তিক বিশ্লেষণ) | ২টি অনুরোধ |
| ভয়েসের বয়স, কৃত্রিম ভয়েস, কথার আবেগ, অডিওর মান, বক্তা যাচাই, ছবি বা একটি নাম বিশ্লেষণ | প্রতি সফল API কলে ১টি অনুরোধ |
| CSV যাচাই | কোনো অনুরোধ কাটে না; সব সারি প্রক্রিয়ার জন্য যথেষ্ট কোটা আছে কি না যাচাই করে |
| CSV প্রক্রিয়াকরণ | প্রতি প্রক্রিয়াকৃত CSV সারিতে ১টি অনুরোধ |
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 ফাইল যাচাই করুন।