Gemini native

Hitung Token

Menghitung token input dari permintaan Gemini tanpa melakukan pembuatan atau penagihan.

POST
/v1beta/models/{model}:countTokens

Menghitung token input dari permintaan Gemini sebelum Anda mengirimkannya. Panggilan ini tidak dikenakan biaya dan tidak memerlukan saldo akun, tetapi memerlukan API key. Gunakan ini dengan model yang respons Dapatkan Model-nya mencantumkan countTokens di dalam supportedGenerationMethods.

Kirimkan contents atau generateContentRequest lengkap. Gunakan hitungan ini untuk perencanaan; biaya untuk permintaan pembuatan (generation) berasal dari usageMetadata pada respons tersebut.

Autentikasi

Sama seperti Hasilkan Konten: ?key=, x-goog-api-key, atau Authorization: Bearer.

Body Permintaan

contentsarray

Konten percakapan dalam bentuk yang sama seperti Hasilkan Konten.

generateContentRequestobject

Permintaan generate Gemini lengkap untuk dihitung, sebagai alternatif untuk contents. generate_content_request juga diterima.

Error

  • 400 INVALID_ARGUMENT: body tidak valid, atau model tidak menerima permintaan Gemini.
  • 401 UNAUTHENTICATED: API key tidak ada atau tidak valid.
  • 503 UNAVAILABLE: tidak ada rute yang tersedia untuk model saat ini. Coba lagi nanti.

Permintaan

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

Respons

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
Jumlah token input dalam permintaan.

Otorisasi

AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

model*string

Nama model (contoh: gemini-2.5-pro)

Parameter query

key?string

Kunci API (alternatif untuk autentikasi header)

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json