פתרון בעיות

עברו על התסמין שתואם למה שאתם רואים. כמעט בכל מקרה, הכרטיסייה Logs היא כלי האבחון המהיר ביותר — היא מציגה את הסטטוס של כל בקשה ואת דפוס הכשל (מפתח אחד? מודל אחד? הכול?). ראו פעילות ויומנים.

בקשות נחסמות

כל בקשה נכשלת עם 402 insufficient_credits

הסיבה: המודול אינו מופעל עבור המתקן הזה, או שהיתרה בתשלום מראש אזלה (הכרטיסייה Overview תציג "Your balance is depleted. Inference requests will be blocked until you top up."). עבור מפתחות API, מתקן שבו Model Router אינו מופעל מחזיר במקום זאת 403 "Model Router is not enabled for this facility".

הפתרון: הפעילו את Model Router מהדף Welcome to Model Router (ראו תחילת העבודה), ולאחר מכן טענו יתרה תחת Budgets & Limits ← Balance & Top-up. הבקשות מתחדשות תוך רגעים מזיכוי היתרה. כדי למנוע הישנות, הפעילו טעינה אוטומטית. ראו תקציבים וטעינות.

בקשות נכשלות עם 402 budget_exceeded

הסיבה: הגעתם למגבלת הוצאה. הודעת השגיאה מציינת לאיזה חלון זמן היא שייכת (יומי / חודשי / לכל התקופה) — ועבור יומי וחודשי, גם מתי בדיוק היא מתאפסת באזור הזמן של המתקן שלכם. ייתכן שזו המגבלה ברמת החשבון כולו, או מגבלה על המפתח הספציפי או על השירות המחובר (ההודעה אומרת "This key's" / "This agent's" כשהמגבלה מוגדרת ברמה זו).

הפתרון: המתינו לאיפוס שצוין, הגדילו את המגבלה (Budgets & Limits ← Spend Limits, או בהגדרות של המפתח או של השירות), או — עבור התקרה הקשיחה לכל התקופה — השתמשו ב-Reset hard cap. הדף Spend Limits מציג בדיוק אילו מגבלות נמצאות במצב "Limit reached".

בקשות נכשלות עם 403 content_policy_violation

הסיבה: ההנחיה תאמה מסנן תוכן במצב block או את מגן הזרקת ההנחיות (prompt injection).

הפתרון: בדקו את Settings ← Guardrails. אם שילוב אחד זקוק באופן לגיטימי לכללים שונים, השתמשו במתג Override facility guardrails שלו במקום להקל את המדיניות של המתקן כולו. ראו Guardrails.

בקשות נכשלות עם 429

הסיבה: המפתח או השירות המחובר חרגו ממגבלת הקצב Requests / min או Tokens / min שלהם.

הפתרון: המתינו ונסו שוב, או הגדילו את מגבלות הקצב בהגדרות של המפתח או של השירות (ריק = ללא הגבלה). ראו מפתחות API.

מודל מסוים מחזיר שגיאות, ואחרים עובדים

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

הפתרון: בדקו את Settings ← Models (האם הוא מופעל?), את הרשימה Restrict models של המפתח, ואת Activity ← Performance ← Reliability & performance by model כדי לראות את שיעור השגיאות של המודל לאורך זמן.

בעיות במפתחות API

401 Unauthorized

הסיבה: עם הקוד invalid_api_key ("Missing or invalid API key"), הכותרת Authorization: Bearer … חסרה או שגויה. ללא קוד ("Invalid API key"), המפתח אינו מוכר (הוקלד בטעות, או סוד ישן אחרי rotate) או revoked (בוטל).

הפתרון: ודאו את תבנית הכותרת; בדקו את סטטוס המפתח ב-Settings ← Service Access & API Keys. הפעילו מחדש מפתח שבוטל, או עדכנו את השירות שלכם לסוד החדש אם המפתח הוחלף.

איבדתי את הסוד של המפתח

הסוד מוצג פעם אחת בלבד בעת היצירה ולא ניתן לשחזר אותו. השתמשו ב-Rotate — מונפק סוד חדש (שמוצג פעם אחת), והמפתח שומר על התווית, המגבלות וההיסטוריה שלו. עדכנו כל שירות שמשתמש במפתח: "You will need to reconfigure any services still using the old key."

המפתח עובד, אבל השימוש מוצג תחת שם שגוי

מפתחות מזוהים לפי ה-Label שלהם ב-Activity וב-Logs. ערכו את המפתח והגדירו תווית בעלת משמעות; תנו לכל מערכת מפתח משלה במקום לשתף מפתח אחד.

בעיות בסוכנים

סוכן מוצג במצב Offline

הסיבה: המכשיר כבוי או שאין לו קישוריות — זו בעיית קישוריות של המכשיר, לא הגדרה של Model Router.

הפתרון: בדקו את החשמל והרשת של המכשיר. תצורת הגישה שלו אינה מושפעת, והיא חוזרת לעבוד ברגע שהוא מתחבר מחדש.

סוכן הפסיק להגיב לבקשות בינה מלאכותית

בדקו, לפי הסדר:

1. יתרה — יתרה שאזלה חוסמת את כל הסוכנים (הסוכן מציג מצב של צורך בקרדיטים). טענו יתרה.
2. מגבלות לכל שירות — Settings ← Service Access & API Keys ← Connected Services: האם הסוכן מציג "Limit reached"? הגדילו את המגבלה או המתינו לאיפוסה.
3. מגבלות החשבון — Budgets & Limits ← Spend Limits.
4. Logs — סננו לפי הסוכן כדי לראות את השגיאה בפועל בבקשות שלו.

שאלות על יתרה וחיובים

נתוני ההוצאה נראים מאחרים

הנתונים Available balance ו-Spent today מוצגים בזמן אמת. Monthly usage מותאם מול היתרה שלכם כל 15 דקות, כך שהוצאה מהזמן האחרון עשויה להופיע שם רק אחרי כמה דקות. היסטוריית העסקאות מציגה רק טעינות והתאמות יתרה, כך שהשימוש לעולם אינו מופיע בה.

הטעינה האוטומטית לא בוצעה

חפשו באנר בדף Balance & Top-up: אין כרטיס שמור, הכרטיס דורש אימות, או שהכרטיס נדחה. תקנו את פרטי הכרטיס (Update card / Edit payment details) או טענו יתרה ידנית. בדיקות הטעינה האוטומטית מתבצעות בערך כל 15 דקות, כך שסף שנחצה זה עתה עשוי להפעיל טעינה רק אחרי כמה דקות.

טעינה נכשלה

"Additional card authentication is required. Please try again." — נסו שוב; ייתכן שהבנק שלכם יבקש אימות. "Top-up could not be completed." — החיוב נדחה; בדקו את הכרטיס או נסו סכום אחר. שום זיכוי אינו מתבצע אלא אם החיוב הצליח.

חויבתי, אבל היתרה לא השתנתה

טעינות מזוכות באופן מיידי — רעננו את הדף. אם היתרה עדיין אינה משקפת חיוב שהצליח, רשמו את ה-Transaction ID ואת ה-Payment reference ממגירת הפרטים של העסקה (או מדף החיובים של הכרטיס) ופתחו בקשת תמיכה.

שאלות על יומנים וניתוח נתונים

בקשה ששלחתי זה עתה עדיין לא מופיעה ב-Logs

הפעילו רענון Live (או לחצו על Refresh now). בקשות מופיעות בדרך כלל תוך רגעים; תחת עומס זה עשוי לקחת מעט יותר זמן.

היומנים מציגים מודל שלא ביקשתי

אם שלחתם model: "auto", היומנים מציגים את המודל שאליו ה-Auto Router בחר לנתב — פתחו את פרטי הבקשה כדי לראות Requested model: auto. זו התנהגות צפויה. ראו מודלים.

שורות מציגות "No charge"

תגובות שנכשלו או שהיו ריקות ולא עלו דבר מסומנות בתג No charge — הן נרשמות לשם השלמות, אבל לא צרכו מהיתרה.

ייצוא ה-CSV שלי קטן מהצפוי

ייצואים גולמיים מוגבלים ל-25,000 שורות — צמצמו את טווח התאריכים או השתמשו בייצוא מסכם. שימו לב גם: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."