دليل المستخدم

رموز الأخطاء

مرجع رموز أخطاء LMU AI: المعاني والحلول لحالات 401 / 403 / 404 / 429 / 5xx، وأكواد الأعمال الخاصة بالصور المجمّعة، والبحث من نص الخطأ الخام وصولاً إلى الحل.

تجمع هذه الصفحة رموز الأخطاء المتناثرة عبر مستندات API الفردية في ورقة مرجعية واحدة. حدّد أولاً الفئة العامة عبر رمز حالة HTTP، ثم ابحث عن الحل المحدد عبر نص الخطأ الخام.

سجّل معرّف الطلب قبل استكشاف الأخطاء

معرّف الطلب في ترويسات الاستجابة هو أكثر معلومة مفيدة على الإطلاق لتشخيص المشكلة. عند التواصل مع الدعم، أدرِج معرّف الطلب ونص الخطأ الكامل — لا ترسل مفتاح API الكامل الخاص بك.

رموز حالة HTTP

الحالةالسبب النموذجيما العمل
400جسم طلب غير صالح، أو مُعامِل، أو معرّف نموذج، أو مسار نموذج؛ تنسيق أو ترميز صورة سيئأصلِح الطلب — لا تكتفِ بإعادة المحاولة؛ تبديل الحسابات أو إعادة المحاولة لن ينجح
401مفتاح API مفقود أو غير صالح أو معطّل؛ Base URL لا يتطابق مع البروتوكول؛ لم يُعَد تشغيل الـ IDE فلا يزال التكوين القديم ساري المفعولتحقق من المفتاح ومن Base URL (انظر بروتوكولات API)، وأعد تشغيل الـ IDE؛ التفاصيل في المشكلة 3
402رصيد غير كافٍاشحن الرصيد أو قلّل حجم العمل
403احتمالان، كلاهما ممكن: ① مجموعة مفتاح API لا تملك تفعيل توليد الصور؛ ② رصيد أو اشتراك أو أهلية فوترة أو صلاحية غير كافيةتأكد أولاً من رصيد الحساب وحالة الاشتراك، ثم تأكد من أن المجموعة تملك القدرة؛ إذا كان كلاهما سليماً واستمر الخطأ، تواصل مع الدعم
404عنوان بروتوكول OpenAI يفتقد إلى /v1، أو عنوان Anthropic يتضمن /v1 عن طريق الخطأ، أو Gemini لا يستخدم /v1beta/models/...؛ أو أن نقطة النهاية غير مدعومة من المجموعة الحاليةأعد التحقق من Base URL ونقطة النهاية الكاملة مقابل بروتوكولات API
413جسم طلب تحويل صورة إلى صورة كبير جداًاضغط الصورة المُدخَلة
429① نفاد الحصة اليومية؛ ② تقييد التزامن أو RPM أو حصة المصدر الأعلىلنفاد الحصة انظر المشكلة 2؛ ولتقييد المعدل، تراجَع أُسّياً وخفّض التزامن وRPM
500خطأ داخلي أو سعةسجّل رمز الخطأ ومعرّف الطلب، وأعد المحاولة عدداً محدوداً من المرات
502فشل مصادقة أو صلاحية أو خدمة المصدر الأعلى مؤقتاًتراجَع وأعد المحاولة؛ تواصل مع الدعم عند الحاجة
503لا يوجد حساب مصدر أعلى متاح أو أن المصدر الأعلى محمّل بشكل زائد؛ قد يكون أيضاً متغير بيئة يتجاوز المفتاحتحقق أولاً من متغيرات البيئة (انظر المشكلة 6)، ثم أعد المحاولة مع تأخير وحركة مرور أقل
504انتهاء مهلة البوابة أو المصدر الأعلىأعد إصدار الطلب كطلب جديد مستقل

ما الذي يُعاد المحاولة عليه، وما الذي يجب إصلاحه بدلاً من ذلك

  • لا تُعِد المحاولة: 400 و401 وأي خطأ صريح متعلق بالرصيد أو الصلاحية أو المُعامِل أو سياسة المحتوى — فالطلب نفسه غير صالح، وأي حساب مصدر أعلى سيعيد النتيجة ذاتها. يجب أن تصلِح الطلب أولاً.
  • آمن لإعادة المحاولة: 429 و502 و503 و504، وانقطاعات الشبكة، وإعادة ضبط الاتصال، ومهلات القراءة — كلها أعطال مؤقتة. استخدم التراجع الأُسّي لعدد محدود من المحاولات (يُوصى بـ 2–3) لتجنّب الدفع مقابل استدعاءات متكررة؛ وعند 429 خفّض أيضاً التزامن وRPM.

هذا التصنيف مأخوذ من إرشادات إعادة المحاولة في واجهات API الخاصة بالصور — انظر Gemini Image · إرشادات إعادة المحاولة.

الأوصاف الكاملة للأخطاء لكل واجهة API: Gemini Image، GPT Image، Grok Image، Gemini Batch Image.

أكواد أخطاء الأعمال (الصور المجمّعة)

إلى جانب رموز حالة HTTP، تُعيد واجهة Gemini Batch Image API أيضاً أكواد أخطاء أعمال، تظهر في وحدة التحكم على شكل error code: BATCH_IMAGE_XXX مع معرّف طلب.

رمز الخطأHTTPالمعنىما العمل
BATCH_IMAGE_DISABLED404توليد الصور المجمّع معطّل بشكل عامأرسل رمز الخطأ ومعرّف الطلب إلى المسؤول
BATCH_IMAGE_GROUP_DISABLED403مجموعة المفتاح الحالي لا تسمح بالصور المجمّعة أو ليست مجموعة Geminiغيّر المفتاح أو اطلب من المسؤول تفعيل صلاحية المجموعة
BATCH_IMAGE_NO_ACCOUNT_AVAILABLE502لا يوجد مورد تنفيذ مجمّع متاح حالياًاحفظ معرّف الطلب وتواصل مع المسؤول
BATCH_IMAGE_SETTLEMENT_PRICING_MISSING400نموذج الدفعة ليس له سعر فوترةاطلب من المسؤول تكوين سعر النموذج
BATCH_IMAGE_INVALID_MODEL400لم يُقدَّم نموذجاستخدم نموذجاً من قائمة نماذج الدفعات
BATCH_IMAGE_INVALID_ITEMS400عناصر أو دقة أو حقول طلب غير صالحةتحقق من جسم الطلب؛ لا يُدعم حالياً سوى 1K
BATCH_IMAGE_DUPLICATE_CUSTOM_ID400custom_id مكررتأكد من أنه فريد ضمن الدفعة
BATCH_IMAGE_PROMPT_TOO_LONG400المطالبة طويلة جداًاختصر المطالبة
BATCH_IMAGE_TOO_MANY_OUTPUT_IMAGES400عدد الصور بعد التوسّع يتجاوز الحدقلّل العناصر أو output_count
BATCH_IMAGE_INVALID_REFERENCE_IMAGE400تنسيق أو حجم أو URI صورة مرجعية غير صالحتحقق من MIME وBase64 وfile_uri
BATCH_IMAGE_INSUFFICIENT_BALANCE402الرصيد منخفض جداً لحجز الرسوماشحن الرصيد أو قلّل حجم العمل
BATCH_IMAGE_IDEMPOTENCY_CONFLICT409نفس مفتاح idempotency يشير إلى جسم طلب مختلفاستخدم Idempotency-Key جديداً
BATCH_IMAGE_PROVIDER_SUBMIT_FAILED502فشل إنشاء مهمة الدفعة في المصدر الأعلىاحفظ معرّف الطلب، وأعد المحاولة عدداً محدوداً من المرات، أو تواصل مع المسؤول
BATCH_IMAGE_QUEUE_FAILED502خدمة المهام غير المتزامنة غير متاحة مؤقتاًاحفظ معرّف الطلب وتواصل مع المسؤول
BATCH_IMAGE_NOT_READY409محاولة التنزيل قبل اكتمال المهمةانتظر حتى تصبح الحالة completed
BATCH_IMAGE_OUTPUT_DELETED410تم تنظيف الناتج بالفعللم يعد بالإمكان تنزيله؛ أنشئ المهمة من جديد
BATCH_IMAGE_ITEM_FAILED409عنصر المهمة المحدد ليس له صورة ناجحةتحقق من item.error
BATCH_IMAGE_DOWNLOAD_LIMITED429تنزيلات متزامنة كثيرة جداًأعد المحاولة لاحقاً

البحث عبر نص الخطأ الخام

طابِق نص الخطأ الذي تراه فعلياً مع الجدول أدناه وانتقل مباشرة إلى الحل التفصيلي.

نص الخطأ الخامالمعنىالحل التفصيلي
stream disconnected before completionانقطاع البث، عادةً بسبب VPN / بروكسي / بروكسي النظام يبدّل عنوان IP للخروجالمشكلة 1
exceeded retry limit, last status: 429 Too Many Requestsنفاد الحصة اليوميةالمشكلة 2
401 Unauthorized: Incorrect API key providedما يزال الطلب يذهب إلى نقطة النهاية الرسمية، لا إلى مُرحِّل LMU AIالمشكلة 3
running scripts is disabled on this system (Windows)قيد سياسة تنفيذ PowerShellالمشكلة 4
CODEX is not recognized as a cmdlet (Windows)Node.js غير مثبّت أو أن PATH معطوبالمشكلة 5
503 No available accountsمتغير بيئة في الصدفة يتجاوز المفتاح المُكوَّن في الـ IDEالمشكلة 6
400 Invalid signature in thinking blockتبديل النماذج عبر المجموعات في محادثة واحدة؛ تعذّر التحقق من توقيع التفكيرالمشكلة 7
400 Unknown parameter: 'tools[0].n'تم إرسال مُعامِل tools عن طريق الخطأ إلى نقطة نهاية صورالمشكلة 8
No available accounts / النموذج غير متاحاستُدعي نموذج خارج النطاق المتاح للمجموعة الحاليةبروتوكولات API ← استكشاف الأخطاء

أخطاء واجهة API لتصدير الاستخدام

تستخدم واجهة API لتصدير الاستخدام مصادقة JWT، لذا تختلف دلالات أخطائها عن قناة مفتاح API أعلاه:

الحالةالسببما العمل
401انتهت صلاحية JWTجدّد باستخدام refresh_token، أو سجّل الدخول مجدداً
403وصول غير مصرّح به (مثلاً الاستعلام عن api_key_id ليس ملكك)تحقق مما إذا كان المفتاح يعود للحساب الحالي
400مُعامِل سيئ (مثلاً تنسيق start_date خاطئ)تحقق من تنسيق YYYY-MM-DD ومن أن timezone صالح

ما زلت عالقاً؟

  • الحالات المشروحة خطوة بخطوة موجودة في الأسئلة الشائعة
  • قواعد Base URL / نقطة النهاية موجودة في بروتوكولات API
  • الحماية من سرقة المفتاح موجودة في أمان المفتاح
  • عند التواصل مع الدعم، أدرِج معرّف الطلب ونص الخطأ الكامل

آخر تحديث:

الأسئلة الشائعة

حلول لأخطاء ومشكلات إعداد LMU AI API الشائعة — 401 / 403 / 429 / 500، احتساب فوترة التوكن، تبديل النماذج، وحل مشكلات Claude Code / Codex CLI.

أمان المفاتيح

دليل القائمة البيضاء/السوداء لعناوين IP لمفاتيح واجهة LMU AI: قيّد عناوين IP التي يمكنها استدعاء مفتاحك لمنع إساءة استخدام مفتاح مُسرَّب؛ يدعم عناوين IP الفردية ونطاقات CIDR.

في هذه الصفحة

رموز حالة HTTPأكواد أخطاء الأعمال (الصور المجمّعة)البحث عبر نص الخطأ الخامأخطاء واجهة API لتصدير الاستخدامما زلت عالقاً؟