Gemini ネイティブ

トークン数をカウントする

Geminiリクエストの入力トークン数を、生成や課金なしでカウントします。

POST
/v1beta/models/{model}:countTokens

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
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!"}]
      }
    ]
  }'

レスポンス

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
リクエスト内の入力トークン数。

認証

AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

model*string

モデル名 (例: gemini-2.5-pro)

クエリパラメータ

key?string

APIキー (ヘッダー認証の代替)

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json