如要進一步瞭解如何使用 Gemini API 計算符記,包括如何計算圖片、音訊和影片,請參閱符記計算指南和隨附的食譜食譜。
方法:models.countTokens
在輸入 Content
上執行模型的剖字器,並傳回符號數。如要進一步瞭解符記,請參閱符記指南。
端點
posthttps: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:countTokens
路徑參數
model
string
必要欄位。模型的資源名稱。這會做為模型使用的 ID。
這個名稱應與 models.list
方法傳回的模型名稱相符。
格式:models/{model}
格式為 models/{model}
。
要求主體
要求主體的資料會採用以下結構:
contents[]
object (Content
)
選用設定。輸入給模型的提示。設定 generateContentRequest
時,系統會忽略這個欄位。
generateContentRequest
object (GenerateContentRequest
)
要求範例
文字
Python
Node.js
Go
貝殼
Kotlin
Swift
Dart
Java
即時通訊
Python
Node.js
Go
貝殼
Kotlin
Swift
Dart
Java
內嵌媒體
Python
Node.js
Go
貝殼
Kotlin
Swift
Dart
Java
影片
Python
Node.js
Go
貝殼
Python
快取
Python
Node.js
Go
系統操作說明
Python
Node.js
Go
Kotlin
Swift
Dart
Java
工具
Python
Node.js
Kotlin
Swift
Dart
Java
回應主體
models.countTokens
的回應。
它會針對 prompt
傳回模型的 tokenCount
。
如果成功,回應主體會含有以下結構的資料:
totalTokens
integer
Model
將 prompt
切割成多少個符記。一律不得為負數。
cachedContentTokenCount
integer
提示 (快取內容) 快取部分中的符記數量。
promptTokensDetails[]
object (ModalityTokenCount
)
僅供輸出。在要求輸入內容中處理的模式清單。
JSON 表示法 |
---|
{
"totalTokens": integer,
"cachedContentTokenCount": integer,
"promptTokensDetails": [
{
object ( |
GenerateContentRequest
要求模型產生完成度。
model
string
必要欄位。用於產生完成作業的 Model
名稱。
格式:models/{model}
。
toolConfig
object (ToolConfig
)
選用設定。工具設定 (適用於要求中指定的任何 Tool
)。如需使用範例,請參閱函式呼叫指南。
safetySettings[]
object (SafetySetting
)
選用設定。用來封鎖不安全內容的 SafetySetting
唯一例項清單。
這項規定將適用於 GenerateContentRequest.contents
和 GenerateContentResponse.candidates
。每個 SafetyCategory
類型應只設定一個設定。API 會封鎖任何不符合這些設定所設門檻的內容和回應。這份清單會覆寫 safetySettings 中指定的每個 SafetyCategory
的預設設定。如果清單中提供的特定 SafetyCategory
沒有 SafetySetting
,API 就會使用該類別的預設安全設定。系統支援的危害類別包括 HARM_CATEGORY_HATE_SPEECH、HARM_CATEGORY_SEXUALLY_EXPLICIT、HARM_CATEGORY_DANGEROUS_CONTENT、HARM_CATEGORY_HARASSMENT 和 HARM_CATEGORY_CIVIC_INTEGRITY。如要進一步瞭解可用的安全設定,請參閱指南。您也可以參閱安全性指南,瞭解如何在 AI 應用程式中納入安全性考量。
generationConfig
object (GenerationConfig
)
選用設定。模型產生和輸出的設定選項。
cachedContent
string
選用設定。快取的內容名稱,用於做為預測的上下文。格式:cachedContents/{cachedContent}
JSON 表示法 |
---|
{ "model": string, "contents": [ { object ( |