الأخطاء

كل خطأ يرجع برمز HTTP وجسمٍ فيه النوع ورسالة عربية ومعرّف الطلب. أرسل request_id مع أي سؤال للدعم.

شكل الخطأ

Error

{  "error": {    "type": "rate_limit_exceeded",    "code": "429",    "message": "تجاوزت حد الطلبات في الدقيقة لهذا المشروع. أعد المحاولة بعد 12 ثانية.",    "request_id": "req_01J9ZK4T"  }}

الرموز

الرمز	النوع	المعنى	ماذا تفعل
400	`invalid_request`	الطلب ناقص أو فيه حقل غير صالح.	صحّح الطلب؛ لا تُعِده كما هو.
400	`content_blocked`	رفض الحارس المحتوى قبل التوليد. لا يُحسب.	عدّل الطلب.
401	`invalid_api_key`	المفتاح مفقود أو ملغى أو خاطئ.	تحقّق من المفتاح ومتغيّر البيئة.
404	`not_found`	النموذج أو المهمة غير موجودة.	تحقّق من المعرّف.
429	`rate_limit_exceeded`	تجاوزت حد الطلبات أو الرموز في الدقيقة.	انتظر ما في `retry-after`.
429	`quota_exceeded`	بلغت سقف الإنفاق أو نفد الرصيد.	ارفع السقف أو اشحن الرصيد.
500	`server_error`	خطأ من جهتنا.	أعد المحاولة بتأخيرٍ متزايد.
503	`overloaded`	ضغطٌ مؤقت على الخدمة.	أعد المحاولة بتأخيرٍ متزايد.

متى تعيد المحاولة

أعد المحاولة مع 429 من نوع rate_limit_exceeded ومع 5xx فقط، بتأخيرٍ يتضاعف.
لا تُعِد 400 و401 و404 كما هي؛ صحّح الطلب أولاً.
الحِزم المتوافقة تعيد المحاولة تلقائياً مع max_retries.