Gemini 原生
計算 Token 數量
在不生成內容或計費的情況下,計算 Gemini 請求的輸入 token 數量。
在發送 Gemini 請求之前計算其輸入 token 數量。此呼叫不會計費,亦不需要帳戶餘額,但需要 API key。請將其與 取得模型 回應中 supportedGenerationMethods 列有 countTokens 的模型搭配使用。
傳送 contents 或完整的 generateContentRequest。請使用此計數進行規劃;生成請求的費用取決於該回應中的 usageMetadata。
身分驗證
與 產生內容 (Generate Content) 相同:?key=、x-goog-api-key 或 Authorization: Bearer。
請求主體
contentsarray
對話內容,格式與 產生內容 (Generate Content) 相同。
generateContentRequestobject
要計算 token 的完整 Gemini 生成請求,可作為 contents 的替代方案。亦支援 generate_content_request。
錯誤
400 INVALID_ARGUMENT:請求主體無效,或該模型不接受 Gemini 請求。401 UNAUTHENTICATED:缺少 API key 或無效。503 UNAVAILABLE:目前該模型沒有可用的路由。請稍後重試。
請求
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!"}]
}
]
}'回應
{
"totalTokens": 7
}totalTokensinteger
請求中的輸入 token 數量。