Method: models.countTokens

توکنایزر مدل را روی محتوای ورودی اجرا می کند و تعداد توکن ها را برمی گرداند.

درخواست HTTP

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

پارامترهای مسیر

مولفه های
model

string

ضروری. نام منبع مدل این به عنوان شناسه ای برای استفاده از مدل عمل می کند.

این نام باید با نام مدلی که با روش models.list برگردانده شده است مطابقت داشته باشد.

قالب: models/{model}

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "generateContentRequest": {
    object (GenerateContentRequest)
  }
}
زمینه های
contents[]

object ( Content )

اختیاری. ورودی به عنوان یک اعلان به مدل داده می شود. این فیلد در صورت تنظیم generateContentRequest نادیده گرفته می شود.

generateContentRequest

object ( GenerateContentRequest )

اختیاری. ورودی کلی که به مدل داده شده است. models.countTokens اعلان، فراخوانی تابع و غیره را شمارش می کند.

بدن پاسخگو

پاسخی از models.countTokens .

tokenCount مدل را برای prompt باز می گرداند.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "totalTokens": integer
}
زمینه های
totalTokens

integer

تعداد نشانه هایی که model prompt به آنها توکن می کند.

همیشه غیر منفی. وقتی cachedContent تنظیم می‌شود، این اندازه هنوز کل اندازه مؤثر است. یعنی این شامل تعداد نشانه های موجود در محتوای کش می شود.

محدوده مجوز

به یکی از حوزه های 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

برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.

Generate ContentRequest

درخواست ایجاد یک تکمیل از مدل.

نمایندگی JSON
{
  "model": string,
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  },
  "cachedContent": string
}
زمینه های
model

string

ضروری. نام Model که برای ایجاد تکمیل استفاده می شود.

قالب: name=models/{model} .

contents[]

object ( Content )

ضروری. محتوای گفتگوی فعلی با مدل.

برای پرس و جوهای تک نوبتی، این یک نمونه است. برای پرس و جوهای چند نوبتی، این یک فیلد تکراری است که حاوی تاریخچه مکالمه + آخرین درخواست است.

tools[]

object ( Tool )

اختیاری. فهرستی از Tools مدل ممکن است برای ایجاد پاسخ بعدی استفاده کند.

Tool قطعه ای از کد است که سیستم را قادر می سازد تا با سیستم های خارجی برای انجام یک عمل یا مجموعه ای از اقدامات خارج از دانش و محدوده مدل تعامل داشته باشد. تنها ابزار پشتیبانی شده در حال حاضر Function است.

toolConfig

object ( ToolConfig )

اختیاری. پیکربندی ابزار برای هر Tool که در درخواست مشخص شده است.

safetySettings[]

object ( SafetySetting )

اختیاری. فهرستی از نمونه‌های SafetySetting منحصر به فرد برای مسدود کردن محتوای ناامن.

این در GenerateContentRequest.contents و GenerateContentResponse.candidates اعمال خواهد شد. برای هر نوع SafetyCategory نباید بیش از یک تنظیم وجود داشته باشد. API هر محتوا و پاسخی را که نتواند آستانه تعیین شده توسط این تنظیمات را برآورده کند مسدود می کند. این فهرست تنظیمات پیش‌فرض را برای هر SafetyCategory مشخص‌شده در تنظیمات ایمنی لغو می‌کند. اگر هیچ SafetySetting برای یک SafetyCategory معین در لیست ارائه نشده باشد، API از تنظیمات ایمنی پیش‌فرض برای آن دسته استفاده می‌کند. دسته‌های آسیب HARM_CATEGORY_HATE_SPEECH، HARM_CATEGORY_SEXUALLY_EXPLICIT، HARM_CATEGORY_DANGEROUS_CONTENT، HARM_CATEGORY_HARASSMENT پشتیبانی می‌شوند.

systemInstruction

object ( Content )

اختیاری. دستورالعمل سیستم مجموعه توسعه دهنده. در حال حاضر فقط پیامک.

generationConfig

object ( GenerationConfig )

اختیاری. گزینه های پیکربندی برای تولید مدل و خروجی ها.

cachedContent

string

اختیاری. نام محتوای ذخیره شده در حافظه پنهان که به عنوان زمینه برای ارائه پیش بینی استفاده می شود. توجه: فقط در حافظه پنهان صریح استفاده می شود، جایی که کاربران می توانند روی حافظه پنهان کنترل داشته باشند (مثلاً چه محتوایی را در حافظه پنهان نگه دارند) و از صرفه جویی تضمین شده در هزینه لذت ببرند. قالب: cachedContents/{cachedContent}