Gemini ネイティブ
トークン数をカウントする
Geminiリクエストの入力トークン数を、生成や課金なしでカウントします。
Geminiリクエストを送信する前に、入力トークン数をカウントします。この呼び出しは課金対象外であり、アカウント残高も必要ありませんが、APIキーは必要です。モデルの取得のレスポンスにおいて、supportedGenerationMethodsにcountTokensが含まれているモデルで使用してください。
contentsまたは完全なgenerateContentRequestのいずれかを送信します。このカウントは計画立案にご利用ください。生成リクエストの料金は、そのレスポンスのusageMetadataに基づいて発生します。
認証
コンテンツの生成と同様です:?key=、x-goog-api-key、またはAuthorization: Bearerを使用します。
リクエストボディ
contentsarray
コンテンツの生成と同じ形式の会話コンテンツ。
generateContentRequestobject
contentsの代わりとして、カウント対象となる完全なGemini生成リクエスト。generate_content_requestも受け付けられます。
エラー
400 INVALID_ARGUMENT: ボディが無効であるか、モデルがGeminiリクエストを受け付けていません。401 UNAUTHENTICATED: APIキーが欠落しているか、無効です。503 UNAVAILABLE: 現在、そのモデルへのルートが利用できません。後で再試行してください。
リクエスト
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:countTokens" \
-H "x-goog-api-key: sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Hello, Gemini!"}]
}
]
}'レスポンス
{
"totalTokens": 7
}totalTokensinteger
リクエスト内の入力トークン数。