count_tokens mide la entrada de Gemini; el uso final incluye otras categorías
La documentación separa la comprobación previa del tamaño y los metadatos de la respuesta. Una ficha de registro evita tratar ambas cifras como una factura equivalente.
Antes de enviar una petición a Gemini se puede comprobar su tamaño con count_tokens. Google especifica que ese resultado cuenta únicamente los tokens de entrada. Después de generar, el objeto usage ofrece categorías de uso como entrada, salida, pensamiento, caché y herramientas. Son dos momentos y dos alcances distintos de observación.
La tokenización también incluye imágenes y otras modalidades, no solo el texto que se ve escrito en una instrucción. Por eso una revisión previa debe conservar qué contenido se envió al contador. Cambiar un adjunto y comparar únicamente la longitud de la frase dejaría sin registrar una diferencia en la petición.
Propuesta propia para evaluar una integración: guardar junto a cada caso el modelo declarado, el contenido de entrada usado para el recuento y el resultado previo; en otra columna, los metadatos devueltos tras la generación. Si una columna falta, se marca como no medida en lugar de estimarla a partir de la otra. No se ha ejecutado aquí una llamada ni medido un consumo real.
El contador previo ayuda a revisar el tamaño de la solicitud, pero no determina por sí solo el gasto final de todas sus categorías. Para una cuenta económica harían falta las condiciones y precios aplicables a ese uso. Esta pieza no proporciona una tarifa, no calcula una factura ni equipara tokens con palabras exactas; documenta qué dato pedir en cada fase para poder compararlo después.