تخطَّ إلى المحتوى
صوتك عربي

الأخطاء

اقرأ أخطاء الواجهة البرمجية وتعامل معها بصورة متسقة.

تستخدم الأخطاء غلافاً متوافقاً مع OpenAI. افحص حالة HTTP أولاً، ثم استخدم error.code في المعالجة البرمجية. احتفظ بـ request_id عندما يكون موجوداً لكي يتمكن الدعم من تتبع الطلب.

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "auth_failed",
    "param": null,
    "request_id": "…"
  }
}

الاستجابات الشائعة

الحالةالمعنىإجراء العميل
400إدخال غير صالح أو خيار غير مدعومصحّح الطلب؛ لا تعِد المحاولة دون تغيير.
401بيانات اعتماد مفقودة أو غير صالحة أو منتهيةاستبدل بيانات الاعتماد.
402الرصيد غير كافٍأضف رصيداً قبل إعادة المحاولة.
403المفتاح لا يملك النطاق المطلوباستخدم مفتاحاً بالصلاحية المطلوبة.
404المورد غير متاح لهذا الحسابتحقّق من المعرّف ومن صلاحية الوصول.
413الطلب أو الرفع كبير جداًخفّض حجم الطلب أو قسّم الملف.
429حد المعدل أو تقييد المصادقةاحترم Retry-After ثم أعد المحاولة بتراجع تدريجي.
5xxعطل مؤقت في الواجهة أو في السعةأعد العمل القابل للإعادة بتراجع محدود.

لا تعرض رسائل الواجهة الخام للمستخدم النهائي. اربط رموز الخطأ الثابتة برسائل واضحة في منتجك، وسجّل معرّف الطلب بصورة منفصلة.

في هذه الصفحة