מדריך לפתרון בעיות

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

קודי שגיאה

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

קוד HTTP סטטוס תיאור פתרון
400 INVALID_ARGUMENT גוף הבקשה ערוך בצורה שגויה. בחומר העזר בנושא API תוכלו למצוא מידע על פורמט הבקשה, דוגמאות וגרסאות נתמכות. השימוש בתכונות מגרסת API חדשה יותר עם נקודת קצה ישנה יותר עלול לגרום לשגיאות.
400 FAILED_PRECONDITION התוכנית ללא תשלום של Gemini API לא זמינה במדינה שלך. עליך להפעיל את החיוב בפרויקט ב-Google AI Studio. כדי להשתמש ב-Gemini API, צריך להגדיר תוכנית בתשלום דרך Google AI Studio.
403 PERMISSION_DENIED למפתח ה-API שלך אין את ההרשאות הנדרשות. מוודאים שמפתח ה-API מוגדר ושיש לו גישה מתאימה.
404 NOT_FOUND המשאב המבוקש לא נמצא. בודקים אם כל הפרמטרים בבקשה תקינים בגרסת ה-API.
429 RESOURCE_EXHAUSTED חרגת ממגבלת כמות התנועה. חשוב לוודא שאתם עומדים במגבלת הקצב של יצירת הבקשות של המודל. מבקשים הגדלה של המכסה במקרה הצורך.
500 פנימי אירעה שגיאה לא צפויה בצד של Google. אפשר להמתין זמן מה ולנסות שוב לשלוח את הבקשה. אם הבעיה נמשכת אחרי הניסיון החוזר, אפשר לדווח על כך באמצעות הלחצן שליחת משוב ב-Google AI Studio.
503 UNAVAILABLE ייתכן שהשירות עמוס או מושבת באופן זמני. אפשר להמתין זמן מה ולנסות שוב לשלוח את הבקשה. אם הבעיה נמשכת אחרי הניסיון החוזר, אפשר לדווח על כך באמצעות הלחצן שליחת משוב ב-Google AI Studio.

בדיקת שגיאות בפרמטרים של המודל בקריאות ל-API

מוודאים שהפרמטרים של המודל עומדים בערכים הבאים:

פרמטר של מודל ערכים (טווח)
מספר המועמדים 1-8 (מספר שלם)
טמפרטורה 0.0-1.0
אסימוני פלט מקסימלי כדאי להשתמש get_model (Python) כדי לקבוע את המספר המרבי של אסימונים למודל שבו אתם משתמשים.
TopP 0.0-1.0

בנוסף לבדיקה של ערכי הפרמטרים, צריך לוודא שמשתמשים גרסת API (למשל, /v1 או /v1beta) וגם שתומך בתכונות הנדרשות לך. לדוגמה, אם תכונה מסוימת נמצאת בגרסת בטא היא תהיה זמינה רק בגרסת API של /v1beta.

כדאי לבדוק אם נמצא הדגם הנכון

חשוב לוודא שאתם משתמשים במודל נתמך שמופיע דף המודלים.

בעיות בטיחות

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

אם מופיע BlockedReason.OTHER, ייתכן שהשאילתה או התשובה מפירות את התנאים של שירות או ללא תמיכה בכל דרך אחרת.

שיפור הפלט של המודל

כדי לקבל פלט איכותי יותר של המודל, כדאי לכתוב הנחיות מובְנות יותר. מבוא לעיצוב הנחיות כמה מושגים בסיסיים, אסטרטגיות ושיטות מומלצות שיעזרו לכם להתחיל.

אם יש לכם מאות דוגמאות לצמדי קלט/פלט טובים, תוכלו כדאי לשקול כוונון של המודל.

הסבר על המגבלות של האסימונים

כדאי לקרוא את מדריך האסימון שלנו כדי להבין טוב יותר איך לספור אסימונים ואת המגבלות שלהם.

בעיות מוכרות

  • ה-API תומך באנגלית בלבד. אם שולחים הנחיות בשפות שונות, ליצור תשובות לא צפויות או אפילו חסומות. ראו זמינים של העדכונים.

דיווח על באג

מצטרפים לדיון בפורום למפתחים של Google AI יש לכם שאלות?