خطأ Gemini ‏FAILED_PRECONDITION: المعنى والسبب والحل

قيد المنطقة، لا خلل في الكود

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

محتوى الرد

جسم استجابة نموذجي، في قالب Google القياسي حيث يعكس حقل code الرقمي حالة HTTP ويحمل status اسم gRPC:

{
  "error": {
    "code": 400,
    "message": "User location is not supported for the API use without a billing account linked.",
    "status": "FAILED_PRECONDITION"
  }
}

الصياغة تختلف حسب الإعداد، لذا اربط معالجتك بسلسلة status، لا بالجملة.

ثلاثة فحوص بالترتيب

أولاً، تحقق من المنطقة الفعلية لمركز البيانات في إعدادات مزوّد الاستضافة. ثانياً، افتح المشروع في Google AI Studio وتأكد من ربط الفوترة. ثالثاً، تأكد أن مفتاح API يعود إلى المشروع نفسه؛ فقد يشير متغير بيئة قديم إلى مشروع تجريبي غير مفوتر.

اضبط الميزانية بعد تفعيل الفوترة

بعد تفعيل الفوترة، أضف تنبيهات للميزانية في اليوم نفسه، ثم احسب تكلفة الاستخدام المتوقع. يبلغ سعر Gemini 3.5 Flash ‏1.50$ للإدخال و9.00$ للإخراج لكل مليون توكن في اللقطة المستخدمة هنا. وإذا كان شرطك ألا تدفع اشتراكاً، فراجع دليل الأدوات المجانية من دون اشتراك وحدود كل خيار.