اگر از اوپن ای آی API میگیرید، ممکن است هنگام کار با آن با خطاهای مختلفی روبهرو شوید. خوشبختانه در بیشتر مواقع جای نگرانی نیست و مشکل سادهتر از چیزی است که به نظر میرسد. بسیاری از خطاها به مواردی مثل API Key اشتباه، تمام شدن اعتبار، ارسال بیش از حد درخواستها یا تنظیمات نادرست درخواست مربوط میشوند و بهراحتی قابل رفع هستند.
در این مقاله از زرین پرداخت، قرار است رایجترین خطاهای OpenAI API و علت آنها را بررسی کنیم. همچنین توضیح میدهیم که برای رفع هر خطا، چه کاری باید انجام داد.
اگر قصد خرید ای پی آی OpenAI را دارید، پیشنهاد میکنیم که حتما این دو مقاله را بهم بخوانید:
- چگونه ChatGPT API بخریم؟ آموزش تصویری
- معرفی مدلهای OpenAI API | بهترین API چت جی پی تی کدام است؟
جدول انواع خطاهای OpenAI API برای دسترسی سریع
| کد خطا | خطا / پیام | علت | روش رفع |
| 400 | Bad Request | درخواست ارسالشده نامعتبر است؛ مثلاً یکی از پارامترها یا ساختار درخواست اشتباه است. | پارامترها، فرمت درخواست و نام مدل را بررسی کنید. |
| 401 | Invalid Authentication | احراز هویت نامعتبر است. | API Key و سازمانی که درخواست با آن ارسال میشود را بررسی کنید. |
| 401 | Incorrect API key provided | API Key واردشده صحیح نیست. | کلید API را بررسی کنید یا یک API Key جدید بسازید. |
| 401 | You must be a member of an organization to use the API | حساب کاربری شما عضو یک سازمان نیست. | از مدیر سازمان بخواهید شما را به Organization اضافه کند. |
| 401 | IP not authorized | IP درخواست با IPهای مجاز تنظیمشده مطابقت ندارد. | درخواست را از IP مجاز ارسال کنید یا تنظیمات IP Allowlist را تغییر دهید. |
| 403 | Country, region, or territory not supported | API از کشور یا منطقه مورد نظر پشتیبانی نمیکند. | بررسی کنید کشور یا منطقه شما در فهرست کشورهای پشتیبانیشده قرار دارد. |
| 404 | Not Found | منبع، مدل یا Endpoint مورد نظر پیدا نشده است. | آدرس Endpoint، نام مدل و مسیر درخواست را بررسی کنید. |
| 409 | Conflict | درخواست با تغییر همزمان روی همان منبع تداخل دارد. | درخواست را دوباره اجرا کنید و مطمئن شوید درخواست دیگری همزمان منبع را تغییر نمیدهد. |
| 422 | Unprocessable Entity | درخواست از نظر ساختار درست است، اما قابل پردازش نیست. | محتوای درخواست و پارامترهای ارسالی را بررسی و دوباره ارسال کنید. |
| 429 | Credit balance exhausted | اعتبار پیشپرداختشده سازمان تمام شده است. | برای ادامه استفاده از API، اعتبار حساب را افزایش دهید. |
| 429 | Rate limit reached for requests | تعداد درخواستها در مدت کوتاه بیش از حد مجاز شده است. | سرعت ارسال درخواستها را کاهش دهید و در صورت وجود، Retry-After را رعایت کنید. |
| 429 | Organization spend limit reached | سقف هزینه تعیینشده برای سازمان پر شده است. | سقف هزینه سازمان را افزایش دهید یا آن را حذف کنید. |
| 429 | Project spend limit reached | سقف هزینه تعیینشده برای پروژه پر شده است. | Spend Limit پروژه را در تنظیمات افزایش دهید یا حذف کنید. |
| 429 | Organization usage limit reached | سازمان به سقف استفاده تعیینشده توسط OpenAI رسیده است. | برای افزایش سقف استفاده درخواست دهید یا با پشتیبانی تماس بگیرید. |
| 500 | The server had an error while processing your request | مشکلی در سرورهای OpenAI رخ داده است. | بعد از مدت کوتاهی دوباره درخواست را ارسال کنید؛ در صورت تداوم مشکل، وضعیت سرویس را بررسی کنید. |
| 503 | The engine is currently overloaded, please try again later | سرورهای OpenAI به دلیل ترافیک بالا با مشکل مواجه شدهاند. | کمی صبر کنید و درخواست را دوباره ارسال کنید. |
| 503 | Slow Down | افزایش ناگهانی نرخ درخواستها روی پایداری سرویس تأثیر گذاشته است. | نرخ درخواستها را کاهش دهید و حداقل 15 دقیقه با سرعت ثابت ادامه دهید؛ سپس بهتدریج سرعت را افزایش دهید. |
| — | You exceeded your current quota | اعتبار تمام شده یا از سهمیه تعیینشده عبور کردهاید. | Billing را بررسی و در صورت نیاز اعتبار حساب را افزایش دهید. |
| — | OpenAI API not working | یک خطای عمومی باعث کار نکردن API شده است. | وضعیت سرویس، API Key و ساختار درخواست را بررسی کنید. |
| — | Rate limit | تعداد درخواستها از حد مجاز بیشتر شده است. | تعداد درخواستها را کاهش دهید و از روش retry استفاده کنید. |
برای مشاهده کامل در موبایل، جدول را به چپ و راست بکشید.
بررسی و رفع کامل خطاهای رایج OpenAI API
خطای 400 OpenAI API
خطای 400 معمولاً زمانی رخ میدهد که درخواست ارسالشده به OpenAI معتبر نباشد. اگر ساختار درخواست یا یکی از پارامترها اشتباه باشد، ممکن است این خطا نمایش داده شود.
همچنین اگر خطای Bad Request گرفتید؛ یعنی درخواست ارسالشده معتبر نیست. پارامترها، فرمت دادهها و نام مدل را بررسی کنید و سپس درخواست را دوباره ارسال کنید.
خطای 401 OpenAI
خطاهای 401 معمولاً به احراز هویت و API Key مربوط میشوند. در این حالت ابتدا مطمئن شوید کلیدی که وارد کردهاید، درست، فعال و مربوط به پروژه یا سازمان مورد نظر است.
- Invalid Authentication: اطلاعات احراز هویت معتبر نیست. API Key و سازمان یا پروژه مربوط به درخواست را بررسی کنید و مطمئن شوید که درست هستند.
- Incorrect API key provided: کلید API اشتباه است یا کلید حذف یا غیرفعال شده است. ابتدا آن را کلید را بررسی کنید و اگر حذف شده، یک API Key جدید بسازید.
- You must be a member of an organization to use the API: حساب شما عضو سازمان مورد نظر نیست. از مدیر سازمان بخواهید شما را به آن اضافه کند.
- IP not authorized: آدرس IP شما در فهرست IPهای مجاز قرار ندارد. IP مجاز را بررسی کنید یا تنظیمات مربوط به IP Allowlist را تغییر دهید.
خطای 403 OpenAI
خطای 403 معمولاً نشان میدهد که دسترسی به API یا قابلیت موردنظر برای درخواست شما مجاز نیست. اگر با این خطا مواجه شدید، ابتدا بررسی کنید که کشور یا منطقه شما تحت پوشش سرویس باشد و حساب شما دسترسی لازم را داشته باشد.
خطای 404 OpenAI API
خطای 404 زمانی رخ میدهد که منبع یا مسیری که درخواست کردهاید پیدا نشود. بنابراین اگر با این خطا مواجه شدید، Endpoint، نام مدل یا شناسه منبع موردنظر را بررسی کنید.
خطای 409 OpenAI API
خطای 409 زمانی رخ میدهد که درخواست شما با یک تغییر همزمان روی همان منبع تداخل داشته باشد. بنابراین اگر با خطای Conflict مواجه شدید، چند لحظه صبر کنید و مطمئن شوید درخواست دیگری همزمان در حال تغییر همان منبع نیست.
خطای 422 OpenAI API
خطای 422 یعنی ساختار کلی درخواست قابل قبول است، اما OpenAI نمیتواند محتوای آن را پردازش کند. بنابراین اگر با خطای Unprocessable Entity مواجه شدید، محتوای دادهها و پارامترهای ارسالی را بررسی و درخواست را اصلاح کنید.
خطای 429 OpenAI API
خطای 429 چند علت مختلف دارد و فقط به زیاد بودن تعداد درخواستها محدود نمیشود. متن دقیق خطا را بررسی کنید تا مشخص شود مشکل از Rate Limit، اعتبار یا محدودیت هزینه است:
- Credit balance exhausted: اعتبار پیشپرداختشده حساب تمام شده است. حساب را شارژ کنید.
- Rate limit reached for requests: تعداد درخواستها یا توکنهای ارسالی در مدت کوتاه بیشتر از حد مجاز شده است. سرعت درخواستها را کاهش دهید و از retry استفاده کنید.
- Organization spend limit reached: سقف هزینه تعیینشده برای Organization پر شده است. Spend Limit سازمان را بررسی و در صورت نیاز افزایش دهید.
- Project spend limit reached: پروژه به سقف هزینه تعیینشده رسیده است. محدودیت هزینه همان Project را بررسی کنید.
- Organization usage limit reached: سازمان به سقف استفاده تعیینشده توسط OpenAI رسیده است. برای افزایش این سقف درخواست دهید یا با پشتیبانی تماس بگیرید.
خطای 500 OpenAI
خطای 500 معمولاً به مشکلی در سمت سرورهای OpenAI مربوط میشود و لزوماً نشاندهنده مشکل در کد شما نیست. بنابراین، باید مدتی صبر کنید تا مشکل سرور برطرف شود و بعد دوباره امتحان کنید.
خطای 503 OpenAI
خطاهای 503 معمولاً زمانی رخ میدهند که سرویس با ترافیک بالا یا افزایش ناگهانی درخواستها مواجه شده باشد. بنابراین اگر با این خطا مواجه شدید، بهتر است مدتی صبر کنید، نرخ درخواستها را کاهش دهید و سپس دوباره درخواست را ارسال کنید. .
اگر مشکل اتصال به OpenAI API رفع نشد؛ چاره چیست؟
اگر همچنان مشکل اتصال به OpenAI API دارید و در جدول بالا خطای مشخصی برای آن پیدا نمیکنید، ابتدا وضعیت اتصال اینترنتتان را بررسی کنید. همچنین اگر از ابزارهای تغییر IP استفاده میکنید، مطمئن شوید که به درستی کار میکند.
در مرحله بعد، API Key و تنظیمات درخواست را بررسی کنید. مطمئن شوید API Key درست را در پروژه خود وارد کردهاید و کلید شما حذف یا غیرفعال نشده است. سپس در کد، آدرس Endpoint، نام مدل و پارامترهای درخواست را بررسی کنید تا اشتباه تایپی یا تنظیمات نادرست وجود نداشته باشد.
در نهایت، اگر این موارد مشکلی نداشتند، ممکن است اختلال موقتی از سمت OpenAI باشد. در این حالت، Service Health را بررسی کنید تا ببینید اختلالی در سرویس موردنظر گزارش شده یا نه. اگر مشکلی وجود داشت، کمی صبر کنید و بعد دوباره درخواست را ارسال کنید.
برای رفع خطای OpenAI API از کجا شروع کنیم؟
برای اینکه گیج نشوید، در این بخش از مقاله یک چکلیست آماده کردهایم. برای رفع خطای اپن ای آی api، کافی است مرحلهبهمرحله پیش بروید:
1. پیام و کد خطا را دقیق بررسی کنید
اول متن و کد خطا را یادداشت کنید و آن را در جدول ابتدای مقاله پیدا کنید. این کار سریعترین راه برای مشخصکردن علت خطا است. سپس با توجه به راه حلهای ذکرشده، اقدام به رفع مشکل کنید.
2. وضعیت تمام شدن اعتبار OpenAI API را بررسی کنید
اگر اعتبار OpenAI API شما تمام شده باشد، ممکن است با پیامهایی مثل Credit balance exhausted، You exceeded your current quota یا insufficient quota مواجه شوید. در این شرایط باید وضعیت Billing و اعتبار حساب را بررسی و در صورت نیاز حساب خود را شارژ کنید.
اگر برای شارژ حساب OpenAI به پرداخت بینالمللی دسترسی ندارید، میتوانید از خدمات زرین پرداخت برای خرید و شارژ OpenAI API استفاده کنید.
3. درخواست را با یک نمونه ساده تست کنید
درخواست را با سادهترین حالت ممکن دوباره اجرا کنید تا ببینید مشکل برطرف شده است یا نه. اگر همچنان خطا دریافت کردید، میتوانید با مقایسه نتیجه این درخواست با درخواست اصلی، مشخص کنید مشکل از خود API است یا به کد، پارامترها و تنظیمات پروژه مربوط میشود.
جمعبندی
همانطور که دیدید، بیشتر خطاهای OpenAI API با یک بررسی مرحلهبهمرحله قابل شناسایی و رفع هستند و معمولاً جای نگرانی نیست. پیشنهاد میکنیم لینک این مقاله را ذخیره کنید تا هر زمان هنگام کار با API با خطا یا مشکلی مواجه شدید، بتوانید سریع به جدول و راهکارهای رفع خطای OpenAI API دسترسی داشته باشید.
همچنین، اگر با خطایی مواجه شدید که در این مقاله درباره آن صحبت نکردهایم، سؤال خودتان را در بخش کامنتها بنویسید تا در اسرع وقت راهنماییتان کنیم.
