সংক্ষিপ্ত বিবরণ
API ব্যবহারে সীমা প্রযোজ্য. এই সীমাগুলো নির্দিষ্ট সময়ের মধ্যে অনুরোধ, টোকেন বা অন্যান্য ব্যবহার সীমিত করে.
429 প্রতিক্রিয়া অস্থায়ী সীমা, প্রিপেইড ব্যালান্স শেষ হওয়া, অথবা ব্যয় বা ব্যবহারের সীমা নির্দেশ করতে পারে. আবার চেষ্টা করার বা বিলিং সেটিংস বদলানোর আগে ত্রুটির বিস্তারিত দেখুন.
কারণ শনাক্ত করুন
ত্রুটির বার্তা এবং error.code দেওয়া থাকলে তা পড়ুন. বিলিং-সম্পর্কিত ত্রুটিতেও বিস্তৃত error.type মান insufficient_quota ব্যবহার হতে পারে.
| ত্রুটি বা কোড | এর অর্থ | করণীয় |
| অনুরোধ বা টোকেনের সীমায় পৌঁছেছে | অনুরোধগুলো প্রযোজ্য সীমা অতিক্রম করছে. | অনুরোধের গতি নিয়ন্ত্রণ করুন এবং নিচের পুনঃচেষ্টা নির্দেশনা অনুসরণ করুন. |
| credit_balance_exhausted | প্রতিষ্ঠানের কোনো প্রিপেইড ক্রেডিট অবশিষ্ট নেই. | আপনার API বিলিং সেটিংসে ক্রেডিট যোগ করুন. |
| organization_usage_limit_exceeded | প্রতিষ্ঠানটি OpenAI-নির্ধারিত ব্যবহার সীমায় পৌঁছেছে. | অনুমোদিত উচ্চতর ব্যবহার সীমার জন্য অনুরোধ করুন. |
| organization_spend_limit_exceeded | প্রতিষ্ঠানটি প্রয়োগকৃত ব্যয় সীমায় পৌঁছেছে. | সীমা বাড়ান বা সরান, অথবা মাসিক রিসেটের জন্য অপেক্ষা করুন. |
| project_spend_limit_exceeded | প্রকল্পটি প্রয়োগকৃত ব্যয় সীমায় পৌঁছেছে. | প্রকল্পের সীমা বাড়ান বা সরান, অথবা মাসিক রিসেটের জন্য অপেক্ষা করুন. |
বিলিং, ব্যয় বা কোটা ত্রুটিতে আবার চেষ্টা করলেই অ্যাক্সেস ফিরে আসে না. আগে জানানো ব্যালান্স বা সীমার সমস্যা সমাধান করুন. প্রয়োগকৃত ব্যয় সীমার পরিবর্তন কার্যকর হতে সময় লাগতে পারে.
ব্যয় সীমা বদলাতে সংশ্লিষ্ট প্রতিষ্ঠান বা প্রকল্পের সেটিংস পরিচালনার অনুমতি প্রয়োজন. আপনার অ্যাক্সেস না থাকলে, যিনি ওই সেটিংস পরিচালনা করেন তাকে বলুন.
প্রিপেইড ক্রেডিট কেনার জন্য দেখুন: প্রিপেইড API বিলিং সেটআপ ও পরিচালনা.
বিভিন্ন ব্যয় নিয়ন্ত্রণ সম্পর্কে জানতে API ব্যয়-সীমা নির্দেশিকা দেখুন.
প্রযোজ্য সীমা দেখুন
আপনার প্রতিষ্ঠানের সীমা পৃষ্ঠায় যান এবং বর্তমান ব্যবহার স্তর ও সীমাগুলো পর্যালোচনা করুন.
সীমা প্রতিষ্ঠান ও প্রকল্প পর্যায়ে প্রযোজ্য হতে পারে. এগুলো ব্যক্তিগত ব্যবহারকারীর বরাদ্দ নয়. মডেলভেদেও সীমা ভিন্ন হয়, এবং কিছু মডেল পরিবার একই সীমা ভাগ করে.
ত্রুটি কোন সীমা নির্দেশ করছে তা দেখুন. যেমন, প্রতি মিনিটে অনুরোধ এবং প্রতি মিনিটে টোকেন আলাদা সীমা. একটির সীমায় পৌঁছালেও অন্যটির নিচে থাকতে পারেন.
আপনার অনুরোধে ব্যবহৃত প্রতিষ্ঠান নিশ্চিত করুন
আপনি একাধিক প্রতিষ্ঠানের সদস্য হলে, আপনার অনুরোধগুলো যেন কাঙ্ক্ষিত প্রতিষ্ঠান ও প্রকল্প ব্যবহার করে তা নিশ্চিত করুন.
আপনার API কী যদি ডিফল্ট প্রতিষ্ঠান ব্যবহার করে, আপনার ডিফল্ট প্রতিষ্ঠানের সেটিং দেখুন. ভিন্ন প্রতিষ্ঠানের বিলিং ব্যবস্থা ও ব্যবহার স্তর ভিন্ন হতে পারে.
অস্থায়ী সীমা-ত্রুটি কমান
অনুরোধের গতি নিয়ন্ত্রণ করুন এবং আকস্মিক চাপ এড়ান
একসঙ্গে অনেক অনুরোধ না পাঠিয়ে সময়ের মধ্যে ছড়িয়ে পাঠান.
দেখানো সময়-ব্যবধানের চেয়েও ছোট সময়ে সীমা প্রয়োগ হতে পারে. যেমন, প্রতি মিনিটে 60টি অনুরোধের সীমা 1-সেকেন্ড সময়কালেও প্রয়োগ হতে পারে. তাই অল্প সময়ের আকস্মিক চাপেও ত্রুটি হতে পারে, যদিও আপনার গড় ব্যবহার প্রতি-মিনিটের সীমার নিচে দেখা যায়.
দীর্ঘ প্রম্পট এবং অপ্রয়োজনীয়ভাবে বড় আউটপুট-টোকেন বরাদ্দও টোকেন-সীমা ত্রুটির কারণ হতে পারে.
বিলম্ব দিয়ে আবার চেষ্টা করুন
সীমা সংক্রান্ত অস্থায়ী ত্রুটির জন্য:
Retry-After প্রতিক্রিয়া হেডার আছে কি না দেখুন.
হেডারে বৈধ বিলম্ব থাকলে, আবার চেষ্টা করার আগে অন্তত ততক্ষণ অপেক্ষা করুন.
হেডার না থাকলে বা অকার্যকর হলে, জিটারসহ এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করুন: প্রতিটি ব্যর্থ চেষ্টার পর বিলম্ব বাড়ান এবং সামান্য এলোমেলো বিলম্ব যোগ করুন.
আবার চেষ্টা করার সংখ্যা এবং এতে মোট কত সময় লাগবে—দুটিই সীমিত রাখুন.
OpenAI-এর অফিসিয়াল SDKগুলো ইতিমধ্যেই উপযুক্ত সীমা-ত্রুটিতে আবার চেষ্টা করে এবং Retry-After থাকলে তা মেনে চলে. আরেকটি পুনঃচেষ্টা লুপ যোগ করার আগে ওই পুনঃচেষ্টাগুলো বিবেচনায় নিন.
ব্যর্থ অনুরোধগুলো প্রতি-মিনিটের সীমায় গণনা হয়. একই অনুরোধ বারবার পাঠালে সমস্যা দীর্ঘস্থায়ী হতে পারে.
বাস্তবায়ন নির্দেশনা ও উদাহরণের জন্য API সীমা নির্দেশিকা দেখুন. আপনার অ্যাপে ব্যবহারের আগে যেকোনো তৃতীয়-পক্ষের পুনঃচেষ্টা লাইব্রেরি পর্যালোচনা করুন.
প্রম্পট ও আউটপুটের আকার পর্যালোচনা করুন
আপনার প্রম্পট থেকে অপ্রয়োজনীয় নির্দেশনা, পুনরাবৃত্ত প্রসঙ্গ এবং উদাহরণ সরান. পরিবর্তিত প্রম্পটটি পরীক্ষা করে নিশ্চিত করুন যে এটি এখনও আপনার প্রয়োজনীয় ফল দেয়.
আপনার এন্ডপয়েন্ট ও মডেল যে আউটপুট-টোকেন প্যারামিটার সমর্থন করে তা ব্যবহার করুন:
Chat Completions-এ max_completion_tokens ব্যবহৃত হয়.
Responses-এ max_output_tokens ব্যবহৃত হয়.
অনুরোধের প্রয়োজনের চেয়ে অনেক বড় বরাদ্দ সেট করা এড়িয়ে চলুন. এই প্যারামিটারগুলো দৃশ্যমান আউটপুটের পাশাপাশি রিজনিং টোকেনও অন্তর্ভুক্ত করে, তাই রিজনিং মডেল ব্যবহার করলে দুটির জন্যই জায়গা রাখুন.
আপনার ব্যবহারের স্তর পর্যালোচনা করুন
একসঙ্গে অনেক অনুরোধ পাঠানো কমিয়ে এবং টোকেনের ব্যবহার পর্যালোচনা করেও যদি ত্রুটি দেখা দিতে থাকে, তাহলে সীমা বাড়ানোর কী কী উপায় আছে তা জানতে আপনার সীমা পৃষ্ঠাটি দেখুন.
আপনার প্রতিষ্ঠানের মোট ক্রেডিট কেনার পরিমাণ বিল্ড, লঞ্চ ও গ্রো স্তরের জন্য নির্ধারিত পরিমাণে পৌঁছালে এর অর্থপ্রদত্ত ব্যবহারের স্তর স্বয়ংক্রিয়ভাবে উন্নীত হয়. উচ্চতর স্তরগুলোতে সাধারণত নির্দিষ্ট সময়ে ব্যবহারের সীমা বেশি থাকে. প্রতিটি স্তরের শর্ত জানতে API ব্যবহারের সীমা সংক্রান্ত নির্দেশিকা দেখুন.
আপনার অনুমোদিত মাসিক ব্যবহারের সীমা এবং নির্দিষ্ট সময়ে অনুরোধ ও টোকেন ব্যবহারের সীমা আলাদা. একটি সীমা বাড়লে অন্যটিও বদলেছে বলে ধরে নেওয়া উচিত নয়.
সমস্যা চলতে থাকলে
উচ্চতর সহায়তায় যাওয়ার আগে
সঠিক ত্রুটির বার্তা, কোনো ত্রুটি কোড, সংশ্লিষ্ট অনুরোধ ID, আপনার সময় অঞ্চলে ত্রুটির সময়, এবং আপনার অ্যাকাউন্টে দেখানো সংশ্লিষ্ট সীমা প্রস্তুত রাখুন. আপনি ইতিমধ্যে যে ধাপগুলো চেষ্টা করেছেন তা নোট করুন.
OpenAI সহায়তার সাথে যোগাযোগ করুন
জানানো সীমা পরীক্ষা করার পরও সমস্যা সমাধান করতে না পারলে হেল্প সেন্টারের মাধ্যমে OpenAI সহায়তার সাথে যোগাযোগ করুন. API কী বা প্রমাণীকরণের অন্য কোনো গোপন তথ্য অন্তর্ভুক্ত করবেন না.