TokenLab

Gemini gốc

Đếm Token

Đếm số lượng token đầu vào của một yêu cầu Gemini mà không cần tạo nội dung hoặc tính phí.

POST
/v1beta/models/{model}:countTokens

Đếm số lượng token đầu vào của một yêu cầu Gemini trước khi bạn gửi đi. Lệnh gọi này không bị tính phí và không yêu cầu số dư tài khoản, nhưng cần có API key. Hãy sử dụng lệnh này với các model có phản hồi Lấy thông tin Model liệt kê countTokens trong supportedGenerationMethods.

Gửi contents hoặc một generateContentRequest đầy đủ. Sử dụng số lượng đếm được để lập kế hoạch; chi phí cho một yêu cầu tạo nội dung sẽ được tính dựa trên usageMetadata trong phản hồi đó.

Xác thực

Tương tự như Tạo nội dung (Generate Content): ?key=, x-goog-api-key, hoặc Authorization: Bearer.

Phần thân yêu cầu (Request Body)

contentsarray

Nội dung hội thoại có cùng cấu trúc như Tạo nội dung (Generate Content).

generateContentRequestobject

Một yêu cầu tạo nội dung Gemini đầy đủ để đếm token, thay thế cho contents. generate_content_request cũng được chấp nhận.

Lỗi

  • 400 INVALID_ARGUMENT: phần thân yêu cầu không hợp lệ, hoặc model không chấp nhận các yêu cầu Gemini.
  • 401 UNAUTHENTICATED: API key bị thiếu hoặc không hợp lệ.
  • 503 UNAVAILABLE: hiện không có tuyến đường nào khả dụng cho model này. Vui lòng thử lại sau.

Yêu cầu

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

Phản hồi

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
Số lượng token đầu vào trong yêu cầu.

Xác thực

AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

model*string

Tên model (ví dụ: gemini-2.5-pro)

Tham số truy vấn

key?string

API key (thay thế cho xác thực bằng header)

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json