أعد طلبًا إلى مساره الصحيح.

تحقق من حالة الخدمة، ثم افصل مشاكل وصول الحساب ومصادقة API واكتشاف النموذج والاستدلال والدفع. ظهور نموذج في الكتالوج لا يثبت التوفر المباشر: GET /v1/models يسرد عمليات النشر المتصلة.

503 service_unavailable يعني أن الخدمة المطلوبة لا يمكنها قبول الطلب. تحقق من حالة الخدمة ومرجع API قبل إعادة المحاولة؛ الطلبات المتكررة لا يمكنها تمكين خدمة غير متاحة. بالنسبة لوحدة GPU مخصصة، انتظر التأكيد على التوفير. بالنسبة للمدفوعات، اتبع تعليمات الأمر وحالة التحقق المسجلة؛ تحديث أمر لا يضيف رصيدًا.

سجّل حالة HTTP ورمز code وmessage الخاص بالخطأ. تحقق من عنوان URL الأساسي لواجهة API المُهيأ، ومعرف النموذج الدقيق، وإصدار العميل قبل تغيير منطق التطبيق.

• 401: تحقق من ترويسة Bearer وما إذا كان المفتاح قد أُلغي. أبقِ المفتاح الكامل خارج السجلات.
• 403: اختر نموذجًا مسموحًا به في قائمة السماح الخاصة بالمفتاح.
• 400 أو 413: تحقق من JSON، والحقول المطلوبة، وحد الإخراج، وميزانية السياق المجمعة للإدخال/الإخراج.
• 402: تحقق مما إذا كان الحساب لديه تعبئة مؤكدة مؤهلة لا تقل عن 100 دولار أمريكي، ثم تحقق من الرصيد المتاح وميزانية المفتاح المحدد؛ لا تحتاج الحسابات المؤهلة إلى الاحتفاظ برصيد 100 دولار أمريكي.
• 429: اتبع ترويسة Retry-After إذا وُجدت، واستخدم إعادة محاولة محدودة، وتحقق من حدود الخدمة المعمول بها؛ لا يوجد بدل تجريبي يومي مجاني.
• 502 أو 503: تحقق من التوفر ورسالة الخطأ قبل إعادة محاولة محدودة.

يشرح دليل الأخطاء والحدود مسارات الاسترداد. قد ينشئ الطلب الجديد عملًا جديدًا؛ لا تفترض أن إعادة محاولات العميل قد أزيل تكرارها.

إغلاق تبويب المتصفح أو انتهاء المهلة أو تدفق مقطوع لا يثبت توقف التوليد. احفظ أي معرف استجابة وإطار الاستخدام النهائي إذا تم استلامه. قد يصل إطار الاستخدام النهائي بعد finish_reason الخاص بالاختيار؛ قطعة شبكة ليست بالضرورة حدثًا كاملاً.

409 pending_reconciliation، أو خطأ علوي بعد الإرسال، يمكن أن يترك الرصيد محجوزًا حتى يتوفر استخدام موثوق. تجنب إرسال طلبات مكررة لمسح الحجز. قارن وقت UTC والنموذج واسم المفتاح مع استخدام وحدة التحكم، واحتفظ بتفاصيل الطلب للمصالحة. أوقات المسح غير مضمونة.

بالنسبة لمشكلة دفع، سجل مرجع الأمر والأصل والشبكة والمبلغ والحالة المرئية. لا ترسل دفعة أخرى أبدًا لمجرد أن الأولى معلقة. السحب إلى محفظة غير متاح حاليًا. إلغاء أمر GPU مدفوع قبل التفعيل يعيد دفعته إلى رصيد حساب WeightsAPI؛ لا يحول الأموال إلى محفظة.

يتضمن التقرير المفيد العملية، والطابع الزمني بتوقيت UTC، ومسار نقطة النهاية، ومعرف النموذج، وحزمة SDK أو التكامل والإصدار، وإعداد البث، وحد رموز الإخراج، والحالة/الخطأ، والنتيجة المتوقعة، والنتيجة الفعلية. أدرج مرجع استجابة أو معاملة فقط إذا كان متاحًا؛ لا تعرض البوابة حاليًا معرّف دعم في كل خطأ.

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

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

لا تُدرج أبدًا سر API، أو ترويسة Authorization، أو ملف تعريف ارتباط جلسة، أو مفتاح محفظة خاص، أو عبارة استرداد، أو ملف بيئة كامل. يكفي اسم المفتاح أو بادئة مختصرة عمدًا لتمييز التطبيقات. قد تربط مراجع المعاملات العامة النشاط بمحفظة؛ فشارك فقط ما يحتاجه التحقيق.

إذا انكشف مفتاح، فأنشئ بديلًا وحدّث التطبيق وألغِ المفتاح القديم. يمنع الإلغاء عمليات الدخول الجديدة؛ وتُسوَّى الطلبات التي سُمح بها سابقًا بشكل طبيعي. انظر المصادقة للتعامل مع المفاتيح.

انسخ وراجع تقريرك، ثم احتفظ به مع مرجع الطلب أو الأمر ذي الصلة. النسخ لا يقدم تذكرة. جهات اتصال الدعم الرسمية وساعات الخدمة غير منشورة؛ استخدم فقط قناة مؤكدة لمشاركة تقرير.

أهداف الاستجابة وجهات اتصال التصعيد وائتمانات الخدمة لم تُحدد. احتفظ ببيانات الاعتماد ومحتوى العميل الحساس خارج تقريرك.