Method: models.countMessageTokens

מפעילה את כלי ההמרה לאסימונים של מודל על מחרוזת ומחזירה את מספר האסימונים.

בקשת HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:countMessageTokens

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
model

string

חובה. שם המשאב של המודל. המזהה הזה משמש עבור המודל.

שם זה צריך להתאים לשם מודל המוחזר על ידי השיטה models.list.

פורמט: models/{model}

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "prompt": {
    object (MessagePrompt)
  }
}
שדות
prompt

object (MessagePrompt)

חובה. הבקשה, שיש להחזיר את מספר האסימונים שלה.

גוף התשובה

תשובה של models.countMessageTokens.

היא מחזירה את הערך tokenCount של המודל עבור prompt.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON
{
  "tokenCount": integer
}
שדות
tokenCount

integer

מספר האסימונים שה-model מבצע להם אסימונים ב-prompt.

תמיד לא שלילי.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

למידע נוסף, קראו את הסקירה הכללית על אימות.