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í.
Đế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)
Nội dung hội thoại có cùng cấu trúc như Tạo nội dung (Generate Content).
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 -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
{
"totalTokens": 7
}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
Tên model (ví dụ: gemini-2.5-pro)
Tham số truy vấn
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