סקירה כללית
שגיאת חיוב או מכסה ב-API עשויה להעיד שהגעתם למגבלת שימוש מאושרת, שהגעתם למגבלת הוצאה שהוגדרה, או שניצלתם את הקרדיטים ששולמו מראש. בדקו את השגיאה לפני שתשנו את ההגדרות.
זהו את השגיאה
בדקו את error.code בתגובת ה-API. גם בשגיאה שקשורה לחיוב, השדה error.type עשוי להכיל את הערך הכללי יותר insufficient_quota.
| קוד השגיאה | משמעות השגיאה | הצעד הבא |
| organization_usage_limit_exceeded | הארגון שלכם הגיע למגבלת השימוש שקבעה לו OpenAI. | בדקו את המגבלה שאושרה לכם ואת האפשרויות להגדלתה. |
| organization_spend_limit_exceeded | הארגון שלכם הגיע לתקרת הוצאה קשיחה שהוגדרה. | בדקו את הגדרות בקרת ההוצאות של הארגון. |
| project_spend_limit_exceeded | הפרויקט שלכם הגיע לתקרת הוצאה קשיחה שהוגדרה. | בדקו את הגדרות בקרת ההוצאות של הפרויקט הזה. |
| credit_balance_exhausted | לא נותרו לארגון שלכם קרדיטים ששולמו מראש. | הוסיפו קרדיטים ליתרת ה-API שלכם. |
שליחה חוזרת של בקשות שנכשלו בשגיאות האלה לא תחזיר את הגישה ללא טיפול בקרדיטים או במגבלות הרלוונטיים. לפרטים, ראו את המדריך לקודי שגיאה ב-API.
בדקו את מגבלת השימוש שאושרה לכם
עברו אל דף המגבלות של הארגון כדי לבדוק את מגבלת השימוש החודשית המאושרת ואת דרגת השימוש הנוכחיות שלו.
דרגות השימוש בתשלום ב-API הן Build, Launch ו-Grow. הארגון שלכם משודרג אוטומטית כשסך רכישות הקרדיטים שלו מגיע ל-$5, ל-$100 ול-$500, בהתאמה. דרגות גבוהות יותר מאפשרות בדרך כלל מגבלות קצב גבוהות יותר. בדקו את הדרגה והמגבלות הנוכחיות של הארגון בדף המגבלות שלו.
ארגונים קיימים שמשתמשים ב-API בתשלום עוברים אוטומטית מדרגות 1–2 ל-Build, מדרגות 3–4 ל-Launch, ומדרגה 5 ל-Grow. אין צורך בתשלום נוסף עבור המעבר הזה. תמחור ה-API ומגבלות הקצב המותאמות אישית נשארים ללא שינוי.
לפרטים על הדרגות, ראו את המדריך למגבלות קצב ב-API.
בדקו את הגדרות בקרת ההוצאות
התראות הוצאה שולחות הודעות בלי לעצור את תעבורת ה-API. תקרות הוצאה קשיחות יכולות לעצור בקשות שעליהן הן חלות כשההוצאות שנרשמו מגיעות לסכום שהוגדר.
מגבלות ברמת הארגון וברמת הפרויקט יכולות לחול במקביל. מגבלה ברמת הארגון חלה על הפרויקטים שלו; מגבלה ברמת הפרויקט חלה על תעבורה שמחויבת לאותו פרויקט. בקרות אלה נפרדות ממגבלת השימוש שאושרה לכם על ידי OpenAI.
אם תקרה קשיחה גרמה לשגיאה ויש צורך להמשיך בהוצאות, מי שיש לו הרשאה לנהל את ההגדרות הרלוונטיות יכול להעלות או להסיר אותה. אחרת, היא מתאפסת בתחילת המחזור החודשי הבא. השינויים והאכיפה אינם מיידיים, ולכן ההוצאות שנרשמו עשויות לחרוג מעט מהסכום שהוגדר.
להגדרות ולהוראות, ראו את המדריך למגבלות הוצאה ב-API.
בדקו את היתרה ששולמה מראש
אם ניצלתם את הקרדיטים ששולמו מראש, עברו אל פורטל החיוב של ה-API ובחרו באפשרות רכישת קרדיטים או הוספה ליתרת הקרדיטים, בהתאם לאפשרות שמופיעה, כדי לרכוש קרדיטים נוספים. ייתכן שיחלפו כמה דקות עד שהיתרה המעודכנת תופיע.
להנחיות להגדרה ולטעינה מחדש, ראו: הגדרת חיוב בתשלום מראש.
בדקו אם השגיאה נובעת ממגבלת קצב
מגבלות קצב של בקשות וטוקנים קובעות באיזה קצב אפשר להשתמש ב-API. הן שונות ממגבלות שימוש חודשיות, מבקרות הוצאות ומהיתרה ששולמה מראש.
לשגיאות של מגבלות קצב בקשות או טוקנים, ראו: פתרון שגיאות של מגבלות קצב ב-API.
אם הבעיה נמשכת
לפני פנייה לתמיכה
הכינו את הודעת השגיאה והקוד שלה, את מועד השגיאה כולל אזור הזמן שלכם, ואת מזהי הבקשות הרלוונטיים. הסירו מידע רגיש מצילומי מסך או מקוד שאתם משתפים.
פנו לתמיכה של OpenAI
אם הצרכים שלכם חורגים מהמגבלות הזמינות לארגון, אם יש לכם מקרה שימוש ייחודי, או אם השגיאה נמשכת לאחר שטיפלתם בגורם לה, פנו לתמיכה של OpenAI באמצעות רכיב הצ'אט במרכז העזרה.
להנחיות ליצירת קשר ולפרטים שיש לכלול בפנייה, ראו: יצירת קשר עם התמיכה.