Token 计数

countTokens 接受 Gemini 兼容内容结构，返回网关对该请求体的 token 估算。当前网关返回的是 AnyPath 估算值，不是上游供应商的计费凭证。

实际扣费请以结算记录和账单导出为准。

路径参数

参数 model

类型：string

位置：path

必填：是

当前 API Key 可用的 Gemini 兼容模型名。

认证

Gemini /v1beta 端点接受：

• Authorization: Bearer sk-your-api-key
• x-goog-api-key: sk-your-api-key
• ?key=sk-your-api-key

请求体

发送以下两种结构之一，不能同时发送：

参数 contents

类型：array

位置：body

Gemini content 数组。

参数 generateContentRequest

类型：object

位置：body

内嵌的 generateContent 请求对象，包含 contents。

响应

响应字段 totalTokens

类型：integer

估算 token 数。

响应字段 cachedContentTokenCount

类型：integer | null

可用时返回 cached content token 数。

请求示例

curl -X POST "https://api.anypath.dev/v1beta/models/gemini-2.5-flash:countTokens?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "Summarize this support case."}]
      }
    ]
  }'

响应示例

{
  "totalTokens": 8,
  "cachedContentTokenCount": null,
  "promptTokensDetails": [],
  "cacheTokensDetails": []
}