Gemini API: أخطاء القيود الإقليمية والخطة المجانية وأذونات مفتاح API
Markdownكيفية التمييز بين 403 Access Restricted و400 FAILED_PRECONDITION و403 PERMISSION_DENIED من خلال نص الخطأ والشروط المنطبقة.
قراءة المقال كاملًا
لكن ليست كل أخطاء Gemini مرتبطة بمنطقتك. أحدها يتعلق بالخطة المجانية، والآخر بمفتاح API نفسه. وبالنسبة إلى البرمجة، يبدو لي Gemini محدود الذكاء بعض الشيء، رغم أنني منحته فرصة ثانية أكثر من مرة.
سأشرح كيف تعرف ما حدث من رسالة الخطأ، وما الذي يمكنك استخدامه بدلاً من Gemini. لنبدأ.
للاطلاع على معلومات حول استخدام الخدمة، راجع وثائق Ailoot.
الخلاصة الرئيسية
يعني 403 Access Restricted انتهاك شروط الوصول. ويعني 400 FAILED_PRECONDITION أن الخطة المجانية غير متاحة في البلد. أما 403 PERMISSION_DENIED المصحوب برسالة عن أذونات المفتاح، فيعني أن المفتاح غير صحيح. استخدم Claude Code للبرمجة؛ وإذا لم ينجح، فاستخدم Codex، ثم Qwen أو DeepSeek.
كيف تتحقق من المناطق التي يدعمها Gemini؟
تحتفظ Google بصفحة منفصلة تسرد البلدان التي تتوفر فيها Gemini API وGoogle AI Studio:
The Gemini API and Google AI Studio are available in the following countries and territories. If you're not in one of these countries or territories, try the Gemini API in Gemini Enterprise Agent Platform
الترجمة: «تتوفر Gemini API وGoogle AI Studio في البلدان والأقاليم التالية. إذا لم تكن في أحد هذه البلدان أو الأقاليم، فجرّب Gemini API في Gemini Enterprise Agent Platform».
تضم القائمة 230 مدخلاً، من ألبانيا إلى جزر آلاند. وGemini Enterprise Agent Platform منصة تابعة لـGoogle Cloud.
إذا أُعيد توجيهك إلى هذه الصفحة بدلاً من AI Studio، تذكر Google 3 أسباب: منطقتك، أو أن عمرك أقل من 18 عاماً، أو أن عمرك غير مُثبت في حسابك على Google.
403 Access Restricted: ما علاقة منطقتك بالأمر؟
تصف Google ذلك على النحو التالي:
If you see a 403 Access Restricted error, you are using Google AI Studio in a way that does not follow the Terms of Service. One common reason is you are not located in a supported region.
الترجمة: «إذا ظهر لك الخطأ 403 Access Restricted، فهذا يعني أنك تستخدم Google AI Studio بطريقة تخالف شروط الخدمة. ومن الأسباب الشائعة أنك لا توجد في منطقة مدعومة».
منطقتك واحدة من 4 عمليات تحقق. أما العمليات الثلاث الأخرى فهي:
- يجب أن يجتاز الطلب فحوصات السلامة الآلية؛
- يجب أن توافق على شروط خدمة Google والشروط الإضافية الخاصة بالذكاء الاصطناعي التوليدي؛
- يجب ألا يكون مشروع Google Cloud قد أُشير إليه بسبب مخالفات.
400 FAILED_PRECONDITION والخطة المجانية
يتعلق هذا الخطأ بالمال. وهذه هي الرسالة الواردة في جدول أخطاء Gemini API:
Gemini API free tier is not available in your country. Please enable billing on your project in Google AI Studio.
الترجمة: «الخطة المجانية لـGemini API غير متاحة في بلدك. يُرجى تفعيل الفوترة لمشروعك في Google AI Studio».
توصي Google بتفعيل خطة مدفوعة في AI Studio، لكن هذا لا ينجح إلا في البلدان المدرجة في القائمة.
403 PERMISSION_DENIED: اقرأ الرسالة
الرقم نفسه، لكن الرسالة الواردة في جدول الأخطاء مختلفة:
Your API key doesn't have the required permissions.
الترجمة: «لا يملك مفتاح API الأذونات المطلوبة».
بحسب Google، يعود ذلك إلى اختيارك مفتاحاً خاطئاً، أو إلى محاولتك الوصول إلى نموذج مضبوط بدقة من دون التفويض المطلوب. تحقق من صحة المفتاح ومن امتلاكه صلاحية الوصول.
لكن يظهر الخطأ PERMISSION_DENIED نفسه في AI Studio أثناء التحقق من المنطقة أيضاً. وتصف Google ذلك في الصفحة التي تتناول عمليات التحقق الأربع. لذا اقرأ الرسالة. إذا كانت تتحدث عن أذونات المفتاح، فتحقق من المفتاح. وإذا كانت تتحدث عن منطقتك، فلا علاقة للمفتاح بالأمر.
هل يستحق Gemini الاستمرار في استخدامه؟
لا أعتقد ذلك بالنسبة إلى البرمجة. لدي Gemini ضمن الخطة الأعلى مستوى، لكنني لا أستخدمه لبناء البرامج. أستخدمه للفيديوهات والصور. أمضيت شهراً أعمل في Google Antigravity، برنامج Google للعمل على الشيفرة، ثم عدت إلى VS Code.
لا يهم أن Gemini يستطيع الاحتفاظ بمليون رمز في ذاكرته: فهو أقل ذكاءً من ChatGPT بعض الشيء. وAntigravity ليس غبياً، بل يعجبني، لكن جودته لا تزال أسوأ بكثير، للأسف. إذا لم يتوفر شيء آخر، فسيفي بالغرض؛ فوجود شيء أفضل من لا شيء.
يبرع Gemini في البحث المعمق عبر الإنترنت عن موضوع ما. فهو Google في النهاية: يلتهم كل موقع إلكتروني، وكل موقع إلكتروني يسمح له بالدخول. لذلك أجري هذا النوع من الأبحاث في Gemini بدلاً من Claude: فـClaude مكلف وسيستهلك كثيراً من الرموز. لكن ضع في اعتبارك أن Gemini يكتب كثيراً وبإسهاب، ولا يستطيع استخلاص الفكرة الأساسية.
ماذا تستخدم بدلاً من Gemini؟
ترتيبي كالتالي. Claude Code، لأنه ببساطة أذكى. لماذا تختار نموذجاً أقل ذكاءً حين يكون الأذكى متاحاً؟ إذا تعذر تشغيله، فاستخدم ChatGPT Codex: الحصول على إمكانية الوصول إليه أسهل، والقيود أقل. وإذا لم ينجح ذلك أيضاً، فهناك نماذج صينية.
يقارن مثال الفيديو نماذج أخرى للبرمجة بأسلوب الارتجال:
يتناول Codex وGemini وQwen وCursor وLovable وBolt وv0، ويشرح سبب اختيار Claude Code في مثال العمل المذكور.
Qwen. Qwen نموذج صيني. يتأخر بنحو 10% عن Opus، أقوى نماذج Claude؛ وهو جيد إلى حد ما لكنه بطيء. أستخدمه أنا أيضاً، أساساً لفحص الشيفرة بحثاً عن الأخطاء. وقد شرحت كيفية إعداده في مقال منفصل.
DeepSeek. هذه منصة صينية. لكنها لا تستطيع التعامل مع مهمة تستمر عدة ساعات: جرّبتها، لكنها تتعطل في أثناء العمل. وقد شرحت اختلافها عن ChatGPT في مقال منفصل.
شرحت أي نموذج تختار لكل مهمة لتجنب دفع مبالغ زائدة في مقال منفصل.
إذا كان Gemini جزءاً من منتجك
أضف نموذجاً احتياطياً منذ البداية. في الحالة المذكورة، استُخدمت واجهة ChatGPT API الرسمية، وحُظر الحساب: فقد عالجت الخدمة نصاً لمستخدم يتضمن عبارات مسيئة. ولم يلاحظ المستخدم الحظر أصلاً، لأن الخدمة انتقلت إلى نموذج صيني عندما تلقت رفضاً.
يتناول مقال منفصل تحليلاً مشابهاً لخطأ المنطقة في Claude Code.
إذا لم يكن Gemini وClaude متاحين في منطقتك، فقارن البدائل المتاحة لمهمتك.
المصادر
- Google: المناطق المتاحة لـGemini API وGoogle AI Studio - قائمة تضم 230 بلداً وإقليماً، و3 أسباب لإحالتك إلى الصفحة، وGemini Enterprise Agent Platform للبلدان غير المدرجة.
- Google: استكشاف مشكلات Google AI Studio وإصلاحها - الخطأ 403 Access Restricted وعمليات التحقق الأربع من الوصول التي قد يظهر خلالها PERMISSION_DENIED.
- Google: أخطاء API - الخطأ 400 FAILED_PRECONDITION الخاص بالخطة المجانية، والخطأ 403 PERMISSION_DENIED الخاص بأذونات المفتاح.
تعرّف على Ailoot.
المزيد من التفاصيل
أسئلة شائعة
هل يعني كل خطأ Gemini 403 أن بلدي غير مدعوم؟
لا. اقرأ رسالة الخطأ كاملة. تشمل فحوص الوصول إلى AI Studio المنطقة والعمر وشروط الحساب؛ أما PERMISSION_DENIED المتعلقة بأذونات المفتاح فتستدعي فحص المفتاح المختار وصلاحياته.
ماذا أفحص إذا أعادت الخطة المجانية FAILED_PRECONDITION؟
تحقق من إتاحة الخطة المجانية لـ Gemini API في بلدك ومشروعك. لا تخلط قيد الخطة المجانية بمفتاح API غير صالح؛ يربط المقال صفحات Google للمناطق واستكشاف الأخطاء الخاصة بهذه الحالة.