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