OpenAI insufficient_quota: معناه وسببه وحله

لماذا يحدث

تستخدم OpenAI الرصيد المدفوع مسبقاً، ويمكنك أيضاً وضع سقف للميزانية. يظهر الخطأ عندما ينفد الرصيد المتاح، أو يبلغ المشروع سقفه، أو تنتهي صلاحية رصيد التجربة، أو يستخدم المفتاح مشروعاً غير المشروع الذي موّلته. ترتبط الحصة بالمشروع، لذلك لا يكفي وجود رصيد في مشروع آخر ضمن الحساب نفسه.

الخطأ الذي سيظهر لك

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details.",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  }
}

حالة HTTP هي 429، وهي الحالة نفسها المستخدمة لحدود المعدل. لذلك افحص نوع الخطأ في جسم الرد؛ فإعادة المحاولة لا تفيد عندما يكون السبب هو الحصة أو الفوترة.

ميّز خطأ الفوترة في الكود

افصل الـ 429 على مستوى المعالِج. إخفاقات الحصة تذهب إلى تنبيه؛ وحدود الاستخدام تذهب إلى التراجع:

# Python — route the two 429s differently
from openai import OpenAI, RateLimitError

client = OpenAI()
try:
    r = client.chat.completions.create(model="gpt-5", messages=msgs)
except RateLimitError as e:
    if "insufficient_quota" in str(e):
        alert_oncall("OpenAI billing exhausted — requests halted")
        raise            # retrying is pointless
    sleep_with_backoff() # a real rate limit — this one heals itself

الوقاية

اضبط تنبيهاً قبل بلوغ سقف الاستخدام، وحدّد ميزانية مستقلة لكل مشروع حتى لا تستهلك مهمة دفعية حصة بقية التطبيقات. وإذا كان الرصيد ينفد أسرع من المتوقع، فراجع حجم الطلبات ووجّه المهام المناسبة إلى نموذج أقل كلفة.