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

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

```json
{
  "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` | عطل مؤقت في الواجهة أو في السعة | أعد العمل القابل للإعادة بتراجع محدود. |

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