היעזרו במדריך זה כדי לאבחן ולפתור בעיות נפוצות שעולות קוראים ל-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 יש לכם שאלות?