Skip to main content

Supports OpenAI GPT, Google Gemini, Anthropic Claude and xAI Grok APIs

To install:

pip install gpt-token-tracker

Examples:

from gpt_token_tracker.token_logger import TokenLogger
from gpt_token_tracker.writers.log_writer import LogWriter
from gpt_token_tracker.pricing import PricingRealtime

log_writer = LogWriter("realtime_tokens")   ### Name of logger
realtime_costs = {
        "text_in": 0.60,
        "cached_text_in": 0.06,
        "text_out": 2.40,
        "audio_in": 10.00,
        "audio_out": 20.00,
        "image_in": 5.00,
        "cached_image_in": 0.50,
        "cached_audio_in": 0.40,
    }
token_logger = TokenLogger(log_writer, PricingRealtime(realtime_costs))

token_logger_realtime.record(realtime_model, realtime_result, fake_realtime_usage)

MODEL_NAME = "gpt-realtime-mini"
response = ...
realtime_result = "This is a fake realtime result"
usage = response.usage
token_logger.record(MODEL_NAME, realtime_result, usage)
from gpt_token_tracker.token_logger import TokenLogger
from gpt_token_tracker.writers.csv_writer import CSVWriter
from gpt_token_tracker.pricing import PricingTextCompletion

csv_writer = CSVWriter("completion_usage.csv")
text_completion_costs = {
        "text_in": 0.25,
        "cached_text_in": 0.025,
        "text_out": 2.00,
    }
csv_token_logger = TokenLogger(csv_writer, PricingTextCompletion(text_completion_costs))

MODEL_NAME = "gpt-5-mini"

response = ...
completion_result = "This is a fake completion result"
usage = response.usage
csv_token_logger.record(MODEL_NAME, completion_result, usage)
from gpt_token_tracker.token_logger import TokenLogger
from gpt_token_tracker.writers.csv_writer import CSVWriter
from gpt_token_tracker.pricing_gemini import PricingGemini

csv_writer = CSVWriter("gemini_usage.csv")
costs = {
        "text_in": 0.10,
        "image_in": 0.10,
        "video_in": 0.10,
        "audio_in": 0.30,
        "cached_text_in": 0.01,
        "cached_video_in": 0.01,
        "cached_image_in": 0.01,
        "cached_audio_in": 0.03,
        "text_out": 0.40,
        "audio_out": 0.40,
        "thinking": 0.40
    }


csv_token_logger = TokenLogger(csv_writer, PricingGemini(costs))

MODEL_NAME = "gemini-2.5-flash-native-audio"

response = ...
result = "This is a fake completion result"
usage = ...
csv_token_logger.record(MODEL_NAME, result, usage)

To run tests:

python -m pip install -r requirements.txt -r requirements_tests.txt --upgrade
python -m pytest tests

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gpt_token_tracker-0.5.0.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gpt_token_tracker-0.5.0-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

File details

Details for the file gpt_token_tracker-0.5.0.tar.gz.

File metadata

  • Download URL: gpt_token_tracker-0.5.0.tar.gz
  • Upload date:
  • Size: 10.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for gpt_token_tracker-0.5.0.tar.gz
Algorithm Hash digest
SHA256 09aa849a3fab8c8b3c91c08c06e364a46928ca6e71a6837d44d18e8e16a0582d
MD5 9df40b210142638ee37a1ad6bc985fbf
BLAKE2b-256 eda4c8f9eb22419f9a65ed5b7b6354592ab30393d2de1bfc480bdd6380d940e9

See more details on using hashes here.

File details

Details for the file gpt_token_tracker-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for gpt_token_tracker-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dcd05e5980ab7aeb0a5f197b7c1a725e9ce7df9980e5c01f904a4bf589ce18a7
MD5 7b93fdfd52e9e121047188068f2fad87
BLAKE2b-256 dbe8b1aa924ebd47f0bee242008d5b6be54ef71739d080631ef389e31c3adc61

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 files

0.4.0

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page