בלוג

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 פועלים:

Gemini API ו-Google AI Studio זמינים במדינות ובטריטוריות הבאות. אם אינכם נמצאים באחת מהמדינות או הטריטוריות האלה, נסו את Gemini API ב-Gemini Enterprise Agent Platform

https://ai.google.dev/gemini-api/docs/available-regions

תרגום: „Gemini API ו-Google AI Studio זמינים במדינות ובטריטוריות הבאות. אם אינכם נמצאים באחת מהן, נסו את Gemini API ב-Gemini Enterprise Agent Platform.”

הרשימה כוללת 230 ערכים, מאלבניה ועד איי Åland. Gemini Enterprise Agent Platform היא פלטפורמה של Google Cloud.

אם מועברים לעמוד הזה במקום ל-AI Studio, Google מציינת 3 סיבות: האזור שלכם, גיל מתחת ל-18, וגיל שלא אומת בחשבון Google שלכם.

403 Access Restricted: מה הקשר לאזור שלכם?

Google מתארת זאת כך:

אם מופיעה לכם שגיאת 403 Access Restricted, אתם משתמשים ב-Google AI Studio באופן שאינו תואם את תנאי השירות. סיבה נפוצה אחת היא שאינכם נמצאים באזור נתמך.

https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio

תרגום: „אם מופיעה לכם שגיאת 403 Access Restricted, אתם משתמשים ב-Google AI Studio באופן שמפר את תנאי השירות. סיבה נפוצה אחת היא שאינכם נמצאים באזור נתמך.”

האזור שלכם הוא אחת מתוך 4 בדיקות. שלוש האחרות הן:

  • הבקשה חייבת לעבור בדיקות בטיחות אוטומטיות;
  • עליכם להסכים לתנאי השירות של Google ולתנאים הנוספים לשימוש בבינה מלאכותית יוצרת;
  • אסור שפרויקט Google Cloud יסומן בשל הפרות.

400 FAILED_PRECONDITION והתוכנית החינמית

השגיאה הזאת קשורה לכסף. כך כתוב בהודעה בטבלת השגיאות של Gemini API:

התוכנית החינמית של Gemini API אינה זמינה במדינה שלכם. הפעילו חיוב בפרויקט שלכם ב-Google AI Studio.

https://ai.google.dev/gemini-api/docs/generate-content/api-errors

תרגום: „התוכנית החינמית של Gemini API אינה זמינה במדינה שלכם. הפעילו חיוב בפרויקט שלכם ב-Google AI Studio.”

Google ממליצה להפעיל תוכנית בתשלום ב-AI Studio. אבל זה עובד רק במדינות שמופיעות ברשימה.

403 PERMISSION_DENIED: קראו את ההודעה

המספר זהה, אבל ההודעה בטבלת השגיאות שונה:

למפתח ה-API שלכם אין את ההרשאות הנדרשות.

https://ai.google.dev/gemini-api/docs/generate-content/api-errors

תרגום: „למפתח ה-API שלכם אין את ההרשאות הנדרשות.”

לפי Google, הסיבות לכך הן שבחרתם במפתח שגוי או שאתם ניגשים למודל שעבר כוונון עדין ללא ההרשאה הנדרשת. בדקו שהמפתח נכון ושהגישה זמינה לכם.

אבל ב-AI Studio, אותה שגיאת PERMISSION_DENIED מתרחשת גם במהלך בדיקת האזור: Google מתארת זאת בעמוד על 4 הבדיקות. לכן קראו את ההודעה. אם היא מזכירה הרשאות למפתח, בדקו את המפתח. אם היא מזכירה את האזור שלכם, אין לכך קשר למפתח.

האם כדאי להמשיך להשתמש ב-Gemini?

לתכנות, לדעתי לא. יש לי את התוכנית ברמה הגבוהה ביותר של Gemini, אבל אני לא בונה איתו תוכנות. אני משתמש בו לסרטונים ולתמונות. עבדתי חודש ב-Google Antigravity, התוכנה של Google לעבודה עם קוד, ובכל זאת חזרתי ל-VS Code.

לא משנה ש-Gemini יכול להחזיק בזיכרון מיליון טוקנים: הוא קצת פחות חכם מ-ChatGPT. Antigravity לא טיפש, ואני אוהב אותו, אבל האיכות עדיין הרבה יותר גרועה, לצערי. אם אין שום דבר אחר זמין, הוא יעשה את העבודה: משהו עדיף על כלום.

Gemini טוב במחקר מעמיק של נושא באינטרנט. בכל זאת, זו Google: היא זוללת כל אתר, וכל אתר מאפשר לה להיכנס. לכן אני עושה מחקר כזה ב-Gemini ולא ב-Claude: Claude יקר ויאכל הרבה טוקנים. אבל קחו בחשבון ש-Gemini כותב הרבה, באריכות, ואינו מצליח לחלץ את הנקודה המרכזית.

במה להשתמש במקום Gemini

הסדר שלי הוא כזה. Claude Code — כי הוא פשוט חכם יותר. למה לבחור במודל פחות חכם כשיש מודל חכם יותר זמין? אם אין דרך לגרום לו לעבוד, השתמשו ב-ChatGPT Codex: קל יותר לקבל גישה ויש פחות חסימות. אם גם זה לא יעבוד, יש מודלים סיניים.

דוגמת הווידאו משווה בין מודלים אחרים לתכנות אווירתי:

הווידאו ייטען כשתגללו
מודלים נוספים לתכנות אווירתי: Codex, Gemini, Qwen ובוני אפליקציות

היא כוללת את Codex, Gemini, Qwen, Cursor, Lovable, Bolt ו-v0, ומסבירה את הבחירה ב-Claude Code בדוגמת העבודה המתוארת.

Qwen. Qwen הוא מודל סיני. הוא נופל מ-Opus, המודל החזק ביותר של Claude, בכ-10%; הוא די טוב, אבל איטי. גם אני משתמש בו, בעיקר כדי לבדוק אם יש באגים בקוד. הסברתי איך להגדיר אותו במאמר נפרד.

DeepSeek. זו פלטפורמה סינית. אבל היא לא מסוגלת להתמודד עם משימה שנמשכת כמה שעות: ניסיתי אותה, והיא מתקלקלת בדרך. הסברתי במה היא שונה מ-ChatGPT במאמר נפרד.

הסברתי איזה מודל לבחור לכל משימה כדי לא לשלם יותר מדי במאמר נפרד.

אם Gemini הוא חלק מהמוצר שלכם

שלבו מודל חלופי כבר מההתחלה. במקרה המתואר, נעשה שימוש ב-API הרשמי של ChatGPT והחשבון נחסם: השירות עיבד טקסט של משתמש שהכיל הערות פוגעניות. המשתמש אפילו לא ראה את החסימה, כי השירות עבר למודל סיני כשקיבל סירוב.

פירוט דומה של שגיאת האזור ב-Claude Code מופיע במאמר נפרד.

אם Gemini ו-Claude אינם זמינים באזור שלכם, השוו בין החלופות הזמינות למשימה שלכם.

מקורות

הכירו את Ailoot.

פרטים נוספים

שאלות ותשובות: Gemini API: שגיאות הקשורות לאזור, לתוכנית החינמית ולהרשאות מפתח ה-API

האם כל שגיאת 403 ב-Gemini אומרת שהמדינה שלי אינה נתמכת?

לא. קראו את הודעת השגיאה המלאה. בדיקות גישה ל-AI Studio כוללות אזור, גיל ותנאי חשבון; הודעת PERMISSION_DENIED על הרשאות מפתח דורשת במקום זאת לבדוק את המפתח שנבחר ואת גישתו.

מה לבדוק כשהתוכנית החינמית מחזירה FAILED_PRECONDITION?

בדקו אם התוכנית החינמית של Gemini API זמינה במדינה ובפרויקט שלכם. אל תבלבלו מגבלת תוכנית חינמית עם מפתח API פגום; המאמר מקשר לעמודי האזורים ופתרון התקלות של Google עבור השגיאה המסוימת.

כל המאמרים