המדריך הזה יעזור לכם לאבחן ולפתור בעיות נפוצות שמתעוררות כשקוראים ל-Gemini API. נתקלתם בבעיות במפתח ה-API? ודאו שהגדרתם את מפתח ה-API בצורה נכונה לפי המדריך להגדרת מפתח API.
קודי שגיאה
בטבלה הבאה מפורטים קודי שגיאות נפוצים שאתם עשויים להיתקל בהם, יחד עם הסברים לסיבות והשלבים לפתרון בעיות:
| קוד HTTP | סטטוס | תיאור | הפתרון |
| 400 | INVALID_ARGUMENT | גוף הבקשה לא תקין. | בחומר העזר בנושא API תוכלו לראות את פורמט הבקשה, דוגמאות וגרסאות נתמכות. שימוש בתכונות מגרסה חדשה יותר של API עם נקודת קצה ישנה יותר עלול לגרום לשגיאות. |
| 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.
בדוק אם יש לך את המודל הנכון
חשוב לוודא שאתם משתמשים במודל נתמך. משתמשים ב-list_models (Python) כדי לקבל את כל המודלים הזמינים לשימוש.
בעיות בטיחות
אם רואים שההודעה נחסמה בגלל הגדרת בטיחות בקריאה ל-API, כדאי לבדוק את הבקשה ביחס למסננים שהגדרתם בקריאת ה-API.
אם מופיע השדה BlockedReason.OTHER, יכול להיות שהשאילתה או התגובה מפירות את התנאים וההגבלות או שאין בהן תמיכה בדרך אחרת.
שיפור הפלט של המודל
כדי לקבל פלטים של המודלים באיכות גבוהה יותר, כדאי לכתוב הנחיות מובנות יותר. בדף המבוא לעיצוב הנחיות יש כמה מושגים בסיסיים, אסטרטגיות ושיטות מומלצות שיעזרו לכם להתחיל.
אם יש לכם מאות דוגמאות לצמדי קלט/פלט טובים, תוכלו גם לשקול כוונון של המודל.
הסבר על המגבלות לאסימונים
באמצעות ה-API ModelService ניתן לקבל מטא-נתונים נוספים על המודלים, כולל המגבלות של אסימוני הקלט והפלט.
כדי לקבל את האסימונים בהנחיה, משתמשים ב-countMessageTokens למודלים של צ'אט וב-countTextTokens למודלים של טקסט.
בעיות מוכרות
- תמיכה בנייד ב-Google AI Studio: אפשר לפתוח את האתר בנייד, אבל הוא לא הותאם למסכים קטנים.
- ממשק ה-API תומך באנגלית בלבד. כששולחים הנחיות בשפות שונות, תשובות לא צפויות או אפילו חסומות. לרשימת השפות הזמינות לעדכונים.
דיווח על באג
לדווח על בעיה ב-GitHub כדי לשאול שאלות או לשלוח בקשות לתכונות או באגים.