למדריך מפורט על ספירת טוקנים באמצעות Gemini API, כולל איך נספרים תמונות, אודיו וסרטונים, ראו את המדריך לספירת טוקנים ואת אוסף הפתרונות הנלווה.
שיטה: models.countTokens
מפעילה את טוקנייזר של מודל על קלט Content ומחזירה את כמות הטוקנים. מידע נוסף על טוקנים זמין במדריך לטוקנים.
נקודת קצה
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
פרמטרים של נתיב
model
string
חובה. שם המשאב של המודל. הערך הזה משמש כמזהה לשימוש במודל.
השם הזה צריך להיות זהה לשם של מודל שמוחזר על ידי השיטה models.list.
פורמט: models/{model} הפורמט הוא models/{model}.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
contents[]
object (Content)
אופציונלי. הקלט שניתן למודל כהנחיה. המערכת מתעלמת מהשדה הזה אם הערך של generateContentRequest מוגדר.
generateContentRequest
object (GenerateContentRequest)
אופציונלי. הקלט הכולל שניתן ל-Model. זה כולל את ההנחיה וגם מידע אחר על הכוונת המודל, כמו הוראות מערכת ו/או הצהרות פונקציות לשימוש בפונקציות. Models/Contents ו-generateContentRequests הם בלעדיים. אפשר לשלוח Model + Contents או generateContentRequest, אבל לא את שניהם.
דוגמה לבקשה
טקסט
Python
Node.js
Go
קונכייה
צ'אט
Python
Node.js
Go
קונכייה
מדיה מוטבעת
Python
Node.js
Go
קונכייה
וידאו
Python
Node.js
Go
קונכייה
Python
מטמון
Python
Node.js
Go
הנחיה למערכת
Go
כלים
Java
גוף התשובה
תשובה מ-models.countTokens.
היא מחזירה את tokenCount של המודל עבור prompt.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
totalTokens
integer
מספר הטוקנים שאליהם הטוקן Model מחלק את הטקסט prompt. הערך תמיד לא שלילי.
cachedContentTokenCount
integer
מספר הטוקנים בחלק המאוחסן במטמון של ההנחיה (התוכן המאוחסן במטמון).
promptTokensDetails[]
object (ModalityTokenCount)
פלט בלבד. רשימת האופנים שעובדו בקלט של הבקשה.
cacheTokensDetails[]
object (ModalityTokenCount)
פלט בלבד. רשימה של אופנויות שעברו עיבוד בתוכן שנשמר במטמון.
| ייצוג ב-JSON |
|---|
{ "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |