סקירה כללית
אפשר לבדוק את השימוש ב-API בשתי דרכים:
השתמשו בלוח בקרת השימוש כדי לבדוק פעילות בתקופת החיוב הנוכחית ובתקופות קודמות.
כדי לבדוק בקשה מסוימת, עיינו בנתוני השימוש שבתגובת ה-API.
Playground משתמש באותן קריאות API כמו היישומים שלכם. הטוקנים שנצרכים בו נספרים כחלק מהשימוש ב-API בחשבון שלכם, וכפופים לאותם כללי שימוש ותמחור.
גישה ללוח הבקרה
כדי לגשת ללוח בקרת השימוש, נדרשת בעלות על הארגון או הרשאת לוח בקרת השימוש.
בדיקת השימוש בלוח הבקרה
פתחו את לוח בקרת השימוש, בחרו את הארגון שברצונכם לבדוק ובחרו את תקופת הדיווח הרלוונטית.
הנתונים בלוח הבקרה מוצגים לפי שעון UTC. הביאו בחשבון את אזור הזמן הזה כשאתם משווים בין הפעילות בלוח הבקרה ליומני היישום שלכם.
בחירת פרויקטים
בלוח הבקרה יש בורר פרויקטים נפרד. הוא פועל באופן בלתי תלוי בפרויקט שנבחר במקום אחר בפלטפורמת API.
השתמשו בבורר שבלוח הבקרה כדי לעיין בנתונים של פרויקט אחד, של כמה פרויקטים או של כל הפרויקטים. כדי לראות את הנתונים של הארגון כולו, בטלו את בחירת הפרויקטים. כשלא נבחר אף פרויקט, לוח הבקרה מציג את נתוני כל הפרויקטים.
בדיקת השימוש של משתמש מסוים
כדי לבדוק את השימוש של משתמש מסוים ב-Responses וב-Chat Completions:
בלוח בקרת השימוש, עברו אל יכולות API > Responses ו-Chat Completions.
בחרו באפשרות סינון לפי.
תחת משתמשים, בחרו את המשתמש ואז בחרו באפשרות החלת מסננים.
הצגת מספר הטוקנים לדקה
בדפי פירוט השימוש אפשר לבחור מרווחי זמן להצגת הנתונים. בחרו מרווח של דקה כדי לבדוק את מספר הטוקנים לדקה (TPM).
מרווח הזמן הזה חל על נתוני השימוש, ולא על נתוני החיוב.
ייצוא נתוני שימוש
אין הגבלה על טווח התאריכים לייצוא. ייצוא של נתונים מתקופה ארוכה עשוי להתפצל למספר קבצים.
למידע על התאמת הנתונים לחשבונית החודשית ועל ייצוא פירוט החיובים, ראו: ייצוא פרטי שימוש חודשיים.
הצגת מענקי קרדיטים
פרטי מענקי הקרדיטים זמינים בדף החיוב של הארגון שלכם.
מענקי קרדיטים ונתוני שימוש ב-API מספקים מידע שונה: מענקי הקרדיטים מציגים את הקרדיטים המשויכים לארגון שלכם, ואילו נתוני השימוש מציגים את פעילות ה-API שלו.
בדיקת השימוש והעלויות ברמת קנה מידה
אם רמת קנה מידה מופעלת בארגון שלכם ויש לכם הרשאות גישה מתאימות, פתחו את דף השימוש ברמת קנה מידה כדי לראות נתוני שימוש מפורטים.
עלויות החבילה של רמת קנה מידה משויכות לארגון, ולא לפרויקטים בודדים.
השימוש גדול מאפס, אך ההוצאה על הפרויקט היא אפס
בדקו אם השימוש במודל מכוסה במכסה שלכם ברמת קנה מידה. אם כל השימוש במודל הזה נמצא במסגרת מכסת הטוקנים לדקה (TPM) של רמת קנה מידה, ייתכן שיוצג שימוש בפרויקט ללא הוצאה נוספת על המודל.
עלות המינוי לרמת קנה מידה נשארת משויכת לארגון. כדי לראות אותה:
בטלו את הסינון לפי פרויקט בלוח בקרת השימוש.
בחרו באפשרות קטגוריות הוצאה.
בדיקת נתונים של כמה ארגונים
לוח בקרת השימוש אינו מאחד נתוני עלויות או שימוש מארגונים שונים. הנתונים של כל ארגון, כולל תת-ארגון, מוצגים בנפרד.
כדי לראות נתונים של תת-ארגון, בחרו אותו בבורר הארגונים.
אם אתם זקוקים לדיווח מאוחד, שקלו להשתמש בפרויקטים בתוך ארגון אחד במקום בתת-ארגונים נפרדים, או השתמשו ב-API לנתוני שימוש לניתוח מותאם אישית.
בדיקת השימוש בטוקנים בתגובת API
שמות השדות של נתוני השימוש בטוקנים משתנים בהתאם ל-endpoint.
| מספר הטוקנים | Chat Completions | Responses |
| טוקני קלט | usage.prompt_tokens | usage.input_tokens |
| טוקני פלט | usage.completion_tokens | usage.output_tokens |
| סך כל הטוקנים | usage.total_tokens | usage.total_tokens |
לדוגמה, תגובת Chat Completions יכולה לכלול:
| { "usage": { "prompt_tokens": 13, "completion_tokens": 7, "total_tokens": 20 }} |
בהתאם ל-endpoint ולמודל, פרטי השימוש עשויים לכלול גם את מספר טוקני הקלט שבמטמון ואת מספר טוקני ה-reasoning. הנתונים האלה עוזרים להסביר מדוע אורך התגובה הגלויה אינו משקף את מלוא השימוש בטוקנים.
להסבר על קטגוריות הטוקנים השונות, ראו: הבנת טוקנים וספירתם.
קבלת נתוני שימוש מ-Chat Completions בהזרמה
בבקשת Chat Completions בהזרמה, כללו את ההגדרות הבאות:
| { "stream": true, "stream_options": { "include_usage": true }} |
כאשר include_usage מופעל, מקטע נוסף לפני data: [DONE] מכיל את נתוני השימוש של הבקשה כולה. מערך choices במקטע הזה ריק. במקטעים האחרים, הערך של usage הוא null.
אם ההזרמה נקטעת, ייתכן שלא תקבלו את המקטע האחרון שמכיל את נתוני השימוש. היעדר המקטע האחרון אינו מוכיח שהבקשה לא צרכה טוקנים.
ההגדרה הזו חלה רק על Chat Completions. לפרטים, ראו את תיעוד ה-API להשלמת צ'אטים.