画像、音声、動画のカウント方法など、Gemini API を使用してトークンをカウントする方法について詳しくは、トークン カウント ガイドと付属のCookbook レシピをご覧ください。
メソッド: models.countTokens
入力 Content
でモデルのトークン化ツールを実行し、トークン数を返します。トークンについて詳しくは、トークン ガイドをご覧ください。
エンドポイント
投稿https: / /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
Shell
Kotlin
Swift
Dart
Java
チャット
Python
Node.js
Go
Shell
Kotlin
Swift
Dart
Java
インライン メディア
Python
Node.js
Go
Shell
Kotlin
Swift
Dart
Java
動画
Python
Node.js
Go
Shell
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 ( |