Gemini nativ

Tokens zählen

Zählt die Eingabe-Tokens einer Gemini-Anfrage, ohne eine Generierung oder Abrechnung durchzuführen.

POST
/v1beta/models/{model}:countTokens

Zählt die Eingabe-Tokens einer Gemini-Anfrage, bevor Sie sie senden. Der Aufruf wird nicht abgerechnet und erfordert kein Kontoguthaben, benötigt jedoch einen API-Key. Verwenden Sie ihn mit einem Modell, dessen Modell abrufen-Antwort countTokens unter supportedGenerationMethods auflistet.

Senden Sie entweder contents oder einen vollständigen generateContentRequest. Nutzen Sie den Zählwert zur Planung; die Abrechnung für eine Generierungsanfrage erfolgt anhand der usageMetadata der jeweiligen Antwort.

Authentifizierung

Identisch mit Inhalte generieren: ?key=, x-goog-api-key oder Authorization: Bearer.

Request-Body

contentsarray

Konversationsinhalte in der gleichen Struktur wie bei Inhalte generieren.

generateContentRequestobject

Ein vollständiger Gemini-Generierungs-Request zum Zählen als Alternative zu contents. generate_content_request wird ebenfalls akzeptiert.

Fehler

  • 400 INVALID_ARGUMENT: Der Body ist ungültig oder das Modell akzeptiert keine Gemini-Anfragen.
  • 401 UNAUTHENTICATED: Der API-Key fehlt oder ist ungültig.
  • 503 UNAVAILABLE: Derzeit ist keine Route für das Modell verfügbar. Versuchen Sie es später erneut.

Anfrage

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

Antwort

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
Anzahl der Eingabe-Tokens in der Anfrage.

Autorisierung

AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

model*string

Modellname (z. B. gemini-2.5-pro)

Abfrageparameter

key?string

API-Schlüssel (Alternative zur Header-Authentifizierung)

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json