الأخطاء الشائعة وفحص الاتصال
401 / مفتاح API غير صالح
تأكد من أن الطلب موجه إلى Base URL الخاص بالموقع، وأن Authorization يستخدم Bearer sk-.... تحقق من صحة المفتاح، وما إذا تم إلغاؤه، وما إذا كانت المجموعة التابعة له صحيحة.
404 / النموذج غير موجود
تحقق بالتتابع من معرف النموذج، وعنوان البروتوكول، ومجموعة المفاتيح. عادةً ما يستخدم OpenAI Compatible عنوانًا يحتوي على /v1؛ وعادةً ما يستخدم Claude Code عنوان الجذر بدون /v1.
403 أو اعتراض من نظام إدارة المخاطر
حدد User-Agent واضح للسكريبت، لتقليل احتمالية اعتراض بوابة الوصول للطلبات ذات User-Agent فارغ. لا تحاول تجاوز القيود عن طريق إعادة المحاولة المستمرة.
بطء الطلب
ابدأ باختبار أسئلة قصيرة. إذا كانت الأسئلة القصيرة سريعة والمهمات المعقدة بطيئة، غالبًا ما يكون السبب في سياق الطلب أو وقت معالجة النموذج؛ إذا كانت الأسئلة القصيرة بطيئة أيضًا، فافحص الشبكة المحلية، وخط الاتصال، وحالة الخدمة.
الاتصال ناجح ولكن العميل لم يتغير
اغلق العميل تمامًا ثم أعد فتحه. تحقق من وجود ملفات إعداد متعددة، أو متغيرات بيئة قديمة تغطي الإعداد الجديد، أو عدم تمكين CC Switch فعليًا للمورد المستهدف.
قائمة التحقق قبل الإطلاق
- تحقق من المفتاح، و Base URL، والنموذج باستخدام أصغر طلب.
- ضبط مهلة، وإعادة المحاولة، والتوازي، وحدود الميزانية.
- تجهيز خط بديل أو نموذج بديل.
- إزالة المعلومات الحساسة من السجلات، وعدم تسجيل المفتاح بالكامل.