Để xem hướng dẫn chi tiết về cách đếm mã thông báo bằng Gemini API, bao gồm cả cách đếm hình ảnh, âm thanh và video, hãy xem Hướng dẫn đếm mã thông báo và Công thức trong sổ tay đi kèm.
Phương thức: models.countTokens
Chạy trình mã hoá từ của mô hình trên đầu vào Content và trả về số lượng mã thông báo. Tham khảo hướng dẫn về mã thông báo để tìm hiểu thêm về mã thông báo.
Điểm cuối
posthttps:
Tham số đường dẫn
model
string
Bắt buộc. Tên tài nguyên của mô hình. Đây là mã nhận dạng mà Mô hình sẽ sử dụng.
Tên này phải khớp với tên mô hình do phương thức models.list trả về.
Định dạng: models/{model}. Tên này có dạng models/{model}.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:
contents[]
object (Content)
Không bắt buộc. Đầu vào được cung cấp cho mô hình dưới dạng câu lệnh. Trường này sẽ bị bỏ qua khi bạn đặt generateContentRequest.
generateContentRequest
object (GenerateContentRequest)
Không bắt buộc. Tổng số đầu vào được cung cấp cho Model. Thông tin này bao gồm cả câu lệnh cũng như các thông tin khác về việc định hướng mô hình, chẳng hạn như hướng dẫn hệ thống và/hoặc khai báo hàm cho tính năng gọi hàm. Models/Contents và generateContentRequests là các tham số loại trừ lẫn nhau. Bạn có thể gửi Model + Content hoặc generateContentRequest, nhưng không được gửi cả hai.
Ví dụ về yêu cầu
Văn bản
Python
Node.js
Go
Vỏ
Chat (Trò chuyện)
Python
Node.js
Go
Vỏ
Nội dung nghe nhìn cùng dòng
Python
Node.js
Go
Vỏ
Video
Python
Node.js
Go
Vỏ
Python
Bộ nhớ đệm
Python
Node.js
Go
Hướng dẫn về hệ thống
Go
Công cụ
Java
Nội dung phản hồi
Câu trả lời của models.countTokens.
Hàm này trả về tokenCount của mô hình cho prompt.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
totalTokens
integer
Số lượng mã thông báo mà Model mã hoá prompt thành. Luôn không âm.
cachedContentTokenCount
integer
Số lượng mã thông báo trong phần được lưu vào bộ nhớ đệm của câu lệnh (nội dung được lưu vào bộ nhớ đệm).
promptTokensDetails[]
object (ModalityTokenCount)
Chỉ có đầu ra. Danh sách các phương thức đã được xử lý trong dữ liệu đầu vào của yêu cầu.
cacheTokensDetails[]
object (ModalityTokenCount)
Chỉ có đầu ra. Danh sách các phương thức đã được xử lý trong nội dung được lưu vào bộ nhớ đệm.
| Biểu diễn dưới dạng JSON | 
|---|
| { "totalTokens": integer, "cachedContentTokenCount": integer, "promptTokensDetails": [ { object ( |