Gemini nativo

Contar Tokens

Conta os tokens de entrada de uma requisição do Gemini sem gerar conteúdo ou faturar.

POST
/v1beta/models/{model}:countTokens

Conta os tokens de entrada de uma requisição do Gemini antes de você enviá-la. A chamada não é cobrada e não precisa de saldo na conta, mas requer uma chave de API. Use-a com um modelo cuja resposta de Obter Modelo liste countTokens em supportedGenerationMethods.

Envie contents ou um generateContentRequest completo. Use a contagem para planejamento; a cobrança por uma requisição de geração vem do usageMetadata dessa resposta.

Autenticação

Igual a Gerar Conteúdo: ?key=, x-goog-api-key ou Authorization: Bearer.

Corpo da Requisição

contentsarray

Conteúdo da conversa no mesmo formato de Gerar Conteúdo.

generateContentRequestobject

Uma requisição completa de geração do Gemini para contar, como alternativa a contents. generate_content_request também é aceito.

Erros

  • 400 INVALID_ARGUMENT: o corpo da requisição não é válido ou o modelo não aceita requisições do Gemini.
  • 401 UNAUTHENTICATED: a chave de API está ausente ou é inválida.
  • 503 UNAVAILABLE: nenhuma rota está disponível para o modelo no momento. Tente novamente mais tarde.

Requisição

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

Resposta

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
Número de tokens de entrada na requisição.

Autorização

AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

model*string

Nome do modelo (ex: gemini-2.5-pro)

Parâmetros de consulta

key?string

Chave de API (alternativa à autenticação via cabeçalho)

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json