Gemini nativo
Contar Tokens
Conta os tokens de entrada de uma requisição do Gemini sem gerar conteúdo ou faturar.
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
Conteúdo da conversa no mesmo formato de Gerar Conteúdo.
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 -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
{
"totalTokens": 7
}Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
Nome do modelo (ex: gemini-2.5-pro)
Parâmetros de consulta
Chave de API (alternativa à autenticação via cabeçalho)
Corpo da requisição
application/json
Resposta
application/json
application/json
application/json
application/json