error.code وحالة HTTP، لا على نص الرسالة. لكل أخطاء Phaseo جسم JSON واحد في جميع نقاط النهاية، وكائن error فيه (code وmessage وtype وparam) هو الشكل الذي تقرؤه حزم SDK المتوافقة مع OpenAI، لذا تحمل استثناءاتها رسالة Phaseo.
الحقول الموجودة في كل خطأ
تضيف بعض الأخطاء سياقًا إضافيًا:
أنواع الأخطاء
يتبعerror.type أنواع الأخطاء الموثّقة لدى OpenAI ويُحدَّد من حالة HTTP:
تستخدم أخطاء
/v1/messages الجسم نفسه، لذا تجد حزم SDK من Anthropic أيضًا error.type وerror.message.
رموز الأخطاء
أعد المحاولة للأخطاء الصحيحة
حدّد عددًا أقصى للمحاولات ومهلة إجمالية. راجع حدود المعدل لمعرفة ترويسات حدود المعدل.
عندما يفشل مزوّد
عندما يصل Phaseo إلى مزوّد ويفشل الطلب مع ذلك، يحتويprovider_failure_diagnostics على category وhint وprovider. الفئات:
عندما لا يتوفر نموذج أو نقطة نهاية
يمكن أن تتضمن أخطاءunsupported_model_or_endpoint الحقول provider_candidate_diagnostics وprovider_enablement وmissing_pricing_providers وrouting_diagnostics. وتميّز معًا بين نموذج لم يُفعَّل بعد، ونموذج لا يدعم نقطة النهاية، وتسعير مفقود، وقيود الإطلاق التدريجي.
عندما يتقاعد نموذج
يظل النموذج المتقاعد متاحًا ما دام أي مزوّد يخدمه. وعندما لا يخدمه أي مزوّد، تفشل الطلبات بالحالة410 والرمز model_retired:
model هو النموذج الذي طلبته، وretired_at هو وقت تقاعده (أو null)، وreplacement_model هو البديل المقترح (أو null).
لا تفيد إعادة المحاولة؛ غيّر معرّف النموذج. لإبقاء هذه الطلبات تعمل أثناء الترحيل، أضف البديل إلى قائمة models في الطلب أو فعّل توجيه النماذج المتقاعدة لمساحة العمل. راجع إيقاف النماذج وتقاعدها.
الأخطاء أثناء البث
إذا فشل الطلب قبل بدء البث، تتلقى جسم خطأ JSON الموضح أعلاه. وإذا فشل في منتصف البث، ينتهي البث بحدث الإخفاق الخاص بنقطة النهاية بدلًا من الإنهاء العادي:
تعامل مع الإخراج الجزئي على أنه غير مكتمل واعرض إعادة المحاولة. يحمل إطار
error في Chat Completions كائن الخطأ نفسه، مع ضبط error.type بناءً على الرمز:
502 مع upstream_stream_failure، لا استجابة جزئية. راجع البث.
تصحيح طلب
أرسل كائنdebug للحصول على تتبعات التوجيه والحمولات المتبادلة مع المزوّد:
trace_level هي summary أو full. قد تحتوي حمولات التصحيح على محتوى طلبك، لذا استخدمها فقط في التطوير أو في بيئات خاضعة لرقابة مشددة. راجع debug.
عندما يفشل طلب، تحقق من صفحة الحالة بحثًا عن حوادث، وقارن حمولتك بصفحة المرجع الخاصة بنقطة النهاية، وسجّل generation_id مع نقطة النهاية والنموذج. أرفق generation_id عند التواصل مع الدعم.