TokenLab

Gemini 原生

計算 Token 數量

在不生成內容或計費的情況下,計算 Gemini 請求的輸入 token 數量。

POST
/v1beta/models/{model}:countTokens

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

回應

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
請求中的輸入 token 數量。

授權

AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

model*string

模型名稱 (例如 gemini-2.5-pro)

查詢參數

key?string

API 金鑰 (標頭驗證的替代方案)

請求主體

application/json

回應

application/json

application/json

application/json

application/json