Method: models.countTokens

تشغّل أداة إنشاء الرموز المميّزة للنموذج على محتوى الإدخال وتعرض عدد الرموز المميّزة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
model

string

مطلوبة. اسم مورد النموذج. ويكون هذا بمثابة معرِّف للنموذج الذي تريد استخدامه.

يجب أن يتطابق هذا الاسم مع اسم النموذج الذي يتم عرضه من خلال طريقة models.list.

تنسيق الملف: models/{model}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "contents": [
    {
      object (Content)
    }
  ]
}
الحقول
contents[]

object (Content)

مطلوبة. تمثّل هذه السمة الإدخال المقدّم إلى النموذج على شكل طلب.

نص الاستجابة

رد من models.countTokens.

وتعرض tokenCount الخاص بالنموذج لـ prompt.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "totalTokens": integer
}
الحقول
totalTokens

integer

تمثّل هذه السمة عدد الرموز المميّزة التي يتم فيها إنشاء رمز مميّز لـ prompt من خلال model.

غير سلبية دائمًا.

نطاقات التفويض

يتطلب استخدام أحد نطاقات 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

لمزيد من المعلومات، راجع نظرة عامة على المصادقة.