voice-prices 0.0.1__tar.gz

voice_prices-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Pydantic Services Inc. 2025 to present
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

voice_prices-0.0.1/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: voice-prices
+Version: 0.0.1
+Summary: Calculate prices for calling LLM, STT and TTS inference APIs. Fork of pydantic/genai-prices with voice-modality support.
+Author: Mahimai Raja J
+Author-email: Mahimai Raja J <mahimairaja3@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Unix
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Environment :: MacOS X
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet
+Requires-Dist: httpx2>=2.0
+Requires-Dist: pydantic>=2.10
+Requires-Dist: pydantic-settings>=2.11 ; extra == 'cli'
+Requires-Dist: rich>=14.3.2 ; extra == 'cli'
+Requires-Dist: rich-argparse>=1.7.2 ; extra == 'cli'
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/mahimailabs/voice-prices
+Project-URL: Source, https://github.com/mahimailabs/voice-prices
+Project-URL: Changelog, https://github.com/mahimailabs/voice-prices/releases
+Provides-Extra: cli
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <h1>voice-prices</h1>
+</div>
+<div align="center">
+  <a href="https://github.com/mahimailabs/voice-prices/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://github.com/mahimailabs/voice-prices/actions/workflows/ci.yml/badge.svg?event=push" alt="CI"></a>
+  <a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/mahimailabs/voice-prices"><img src="https://coverage-badge.samuelcolvin.workers.dev/mahimailabs/voice-prices.svg" alt="Coverage"></a>
+  <a href="https://pypi.python.org/pypi/voice-prices"><img src="https://img.shields.io/pypi/v/voice-prices.svg" alt="PyPI"></a>
+  <a href="https://github.com/mahimailabs/voice-prices"><img src="https://img.shields.io/pypi/pyversions/voice-prices.svg" alt="versions"></a>
+  <a href="https://github.com/mahimailabs/voice-prices/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mahimailabs/voice-prices.svg" alt="license"></a>
+  <a href="https://logfire.pydantic.dev/docs/join-slack/"><img src="https://img.shields.io/badge/Slack-Join%20Slack-4A154B?logo=slack" alt="Join Slack" /></a>
+</div>
+
+<br/>
+<div align="center">
+  Python package for <a href="https://github.com/mahimailabs/voice-prices">github.com/mahimailabs/voice-prices</a>.
+</div>
+<br/>
+
+## Installation
+
+```bash
+uv add voice-prices
+```
+
+(or `pip install voice-prices` if you're old school)
+
+To use the CLI with Rich output/help, install the optional CLI dependencies:
+
+```bash
+uv add "voice-prices[cli]"
+```
+
+(or `pip install "voice-prices[cli]"`)
+
+## Warning: these prices will not be 100% accurate
+
+See [the project README](https://github.com/mahimailabs/voice-prices?tab=readme-ov-file#warning) for more information.
+
+## Usage
+
+### `calc_price`
+
+```python
+from voice_prices import Usage, calc_price
+
+price_data = calc_price(
+    Usage(input_tokens=1000, output_tokens=100),
+    model_ref='gpt-4o',
+    provider_id='openai',
+)
+print(f"Total Price: ${price_data.total_price} (input: ${price_data.input_price}, output: ${price_data.output_price})")
+```
+
+### `extract_usage`
+
+`extract_usage` can be used to extract usage data and the `model_ref` from response data,
+which in turn can be used to calculate prices:
+
+```py
+from voice_prices import extract_usage
+
+response_data = {
+    'model': 'claude-sonnet-4-20250514',
+    'usage': {
+        'input_tokens': 504,
+        'cache_creation_input_tokens': 123,
+        'cache_read_input_tokens': 0,
+        'output_tokens': 97,
+    },
+}
+extracted_usage = extract_usage(response_data, provider_id='anthropic')
+price = extracted_usage.calc_price()
+print(price.total_price)
+```
+
+or with OpenAI where there are two API flavors:
+
+```py
+from voice_prices import extract_usage
+
+response_data = {
+    'model': 'gpt-5',
+    'usage': {'prompt_tokens': 100, 'completion_tokens': 200},
+}
+extracted_usage = extract_usage(response_data, provider_id='openai', api_flavor='chat')
+price = extracted_usage.calc_price()
+print(price.total_price)
+```
+
+### `UpdatePrices`
+
+`UpdatePrices` can be used to periodically update the price data by downloading it from GitHub
+
+Please note:
+
+- this functionality is explicitly opt-in
+- we download data directly from GitHub (`https://raw.githubusercontent.com/mahimailabs/voice-prices/refs/heads/main/prices/data.json`) so we don't and can't monitor requests or gather telemetry
+
+At the time of writing, the `data.json` file
+downloaded by `UpdatePrices` is around 26KB when compressed, so is generally very quick to download.
+
+By default `UpdatePrices` downloads price data immediately after it's started in the background, then every hour after that.
+
+Usage with `UpdatePrices` as as context manager:
+
+```py
+from voice_prices import UpdatePrices, Usage, calc_price
+
+with UpdatePrices() as update_prices:
+    update_prices.wait()  # optionally wait for prices to have updated
+    p = calc_price(Usage(input_tokens=123, output_tokens=456), 'gpt-5')
+    print(p)
+```
+
+Usage with `UpdatePrices` as a simple class:
+
+```py
+from voice_prices import UpdatePrices, Usage, calc_price
+
+update_prices = UpdatePrices()
+update_prices.start(wait=True)  # start updating prices, optionally wait for prices to have updated
+p = calc_price(Usage(input_tokens=123, output_tokens=456), 'gpt-5')
+print(p)
+update_prices.stop()  # stop updating prices
+```
+
+Only one `UpdatePrices` instance can be running at a time.
+
+If you'd like to wait for prices to be updated without access to the `UpdatePrices` instance, you can use the `wait_prices_updated_sync` function:
+
+```py
+from voice_prices import wait_prices_updated_sync
+
+wait_prices_updated_sync()
+...
+```
+
+Or it's async variant, `wait_prices_updated_async`.
+
+### CLI Usage
+
+Run the CLI with:
+
+```bash
+uvx voice-prices --help
+```
+
+Or, if installed locally, make sure CLI extras are present:
+
+```bash
+pip install "voice-prices[cli]"
+voice-prices --help
+```
+
+If local CLI extras are not installed, the command will print an install hint for `voice-prices[cli]`.
+
+To list providers and models, run:
+
+```bash
+uvx voice-prices list
+```
+
+To calculate the price of models, run for example:
+
+```bash
+uvx voice-prices calc --input-tokens 100000 --output-tokens 3000 o1 o3 claude-opus-4
+```
+
+CLI output notes:
+
+- Rich output is the default.
+- Use `--plain` (`-p`) for legacy/plain output.
+- Use `--no-color` to keep rich formatting without colors.
+- Use `-T` / `--table` for wide table output.
+
+## Further Documentation
+
+We do not yet build API documentation for this package, but the source code is relatively simple and well documented.
+
+If you need further information on the API, we encourage you to read the source code.

voice_prices-0.0.1/README.md

@@ -0,0 +1,180 @@
+<div align="center">
+  <h1>voice-prices</h1>
+</div>
+<div align="center">
+  <a href="https://github.com/mahimailabs/voice-prices/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://github.com/mahimailabs/voice-prices/actions/workflows/ci.yml/badge.svg?event=push" alt="CI"></a>
+  <a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/mahimailabs/voice-prices"><img src="https://coverage-badge.samuelcolvin.workers.dev/mahimailabs/voice-prices.svg" alt="Coverage"></a>
+  <a href="https://pypi.python.org/pypi/voice-prices"><img src="https://img.shields.io/pypi/v/voice-prices.svg" alt="PyPI"></a>
+  <a href="https://github.com/mahimailabs/voice-prices"><img src="https://img.shields.io/pypi/pyversions/voice-prices.svg" alt="versions"></a>
+  <a href="https://github.com/mahimailabs/voice-prices/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mahimailabs/voice-prices.svg" alt="license"></a>
+  <a href="https://logfire.pydantic.dev/docs/join-slack/"><img src="https://img.shields.io/badge/Slack-Join%20Slack-4A154B?logo=slack" alt="Join Slack" /></a>
+</div>
+
+<br/>
+<div align="center">
+  Python package for <a href="https://github.com/mahimailabs/voice-prices">github.com/mahimailabs/voice-prices</a>.
+</div>
+<br/>
+
+## Installation
+
+```bash
+uv add voice-prices
+```
+
+(or `pip install voice-prices` if you're old school)
+
+To use the CLI with Rich output/help, install the optional CLI dependencies:
+
+```bash
+uv add "voice-prices[cli]"
+```
+
+(or `pip install "voice-prices[cli]"`)
+
+## Warning: these prices will not be 100% accurate
+
+See [the project README](https://github.com/mahimailabs/voice-prices?tab=readme-ov-file#warning) for more information.
+
+## Usage
+
+### `calc_price`
+
+```python
+from voice_prices import Usage, calc_price
+
+price_data = calc_price(
+    Usage(input_tokens=1000, output_tokens=100),
+    model_ref='gpt-4o',
+    provider_id='openai',
+)
+print(f"Total Price: ${price_data.total_price} (input: ${price_data.input_price}, output: ${price_data.output_price})")
+```
+
+### `extract_usage`
+
+`extract_usage` can be used to extract usage data and the `model_ref` from response data,
+which in turn can be used to calculate prices:
+
+```py
+from voice_prices import extract_usage
+
+response_data = {
+    'model': 'claude-sonnet-4-20250514',
+    'usage': {
+        'input_tokens': 504,
+        'cache_creation_input_tokens': 123,
+        'cache_read_input_tokens': 0,
+        'output_tokens': 97,
+    },
+}
+extracted_usage = extract_usage(response_data, provider_id='anthropic')
+price = extracted_usage.calc_price()
+print(price.total_price)
+```
+
+or with OpenAI where there are two API flavors:
+
+```py
+from voice_prices import extract_usage
+
+response_data = {
+    'model': 'gpt-5',
+    'usage': {'prompt_tokens': 100, 'completion_tokens': 200},
+}
+extracted_usage = extract_usage(response_data, provider_id='openai', api_flavor='chat')
+price = extracted_usage.calc_price()
+print(price.total_price)
+```
+
+### `UpdatePrices`
+
+`UpdatePrices` can be used to periodically update the price data by downloading it from GitHub
+
+Please note:
+
+- this functionality is explicitly opt-in
+- we download data directly from GitHub (`https://raw.githubusercontent.com/mahimailabs/voice-prices/refs/heads/main/prices/data.json`) so we don't and can't monitor requests or gather telemetry
+
+At the time of writing, the `data.json` file
+downloaded by `UpdatePrices` is around 26KB when compressed, so is generally very quick to download.
+
+By default `UpdatePrices` downloads price data immediately after it's started in the background, then every hour after that.
+
+Usage with `UpdatePrices` as as context manager:
+
+```py
+from voice_prices import UpdatePrices, Usage, calc_price
+
+with UpdatePrices() as update_prices:
+    update_prices.wait()  # optionally wait for prices to have updated
+    p = calc_price(Usage(input_tokens=123, output_tokens=456), 'gpt-5')
+    print(p)
+```
+
+Usage with `UpdatePrices` as a simple class:
+
+```py
+from voice_prices import UpdatePrices, Usage, calc_price
+
+update_prices = UpdatePrices()
+update_prices.start(wait=True)  # start updating prices, optionally wait for prices to have updated
+p = calc_price(Usage(input_tokens=123, output_tokens=456), 'gpt-5')
+print(p)
+update_prices.stop()  # stop updating prices
+```
+
+Only one `UpdatePrices` instance can be running at a time.
+
+If you'd like to wait for prices to be updated without access to the `UpdatePrices` instance, you can use the `wait_prices_updated_sync` function:
+
+```py
+from voice_prices import wait_prices_updated_sync
+
+wait_prices_updated_sync()
+...
+```
+
+Or it's async variant, `wait_prices_updated_async`.
+
+### CLI Usage
+
+Run the CLI with:
+
+```bash
+uvx voice-prices --help
+```
+
+Or, if installed locally, make sure CLI extras are present:
+
+```bash
+pip install "voice-prices[cli]"
+voice-prices --help
+```
+
+If local CLI extras are not installed, the command will print an install hint for `voice-prices[cli]`.
+
+To list providers and models, run:
+
+```bash
+uvx voice-prices list
+```
+
+To calculate the price of models, run for example:
+
+```bash
+uvx voice-prices calc --input-tokens 100000 --output-tokens 3000 o1 o3 claude-opus-4
+```
+
+CLI output notes:
+
+- Rich output is the default.
+- Use `--plain` (`-p`) for legacy/plain output.
+- Use `--no-color` to keep rich formatting without colors.
+- Use `-T` / `--table` for wide table output.
+
+## Further Documentation
+
+We do not yet build API documentation for this package, but the source code is relatively simple and well documented.
+
+If you need further information on the API, we encourage you to read the source code.

voice_prices-0.0.1/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["uv_build>=0.8.10"]
+build-backend = "uv_build"
+
+[project]
+name = "voice-prices"
+version = "0.0.1"
+description = "Calculate prices for calling LLM, STT and TTS inference APIs. Fork of pydantic/genai-prices with voice-modality support."
+readme = "README.md"
+authors = [{ name = "Mahimai Raja J", email = "mahimairaja3@gmail.com" }]
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Unix",
+    "Operating System :: POSIX :: Linux",
+    "Environment :: Console",
+    "Environment :: MacOS X",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet",
+]
+dependencies = [
+    "httpx2>=2.0",
+    "pydantic>=2.10",
+]
+
+[project.optional-dependencies]
+cli = [
+    "pydantic-settings>=2.11",
+    "rich>=14.3.2",
+    "rich-argparse>=1.7.2",
+]
+
+[project.scripts]
+voice-prices = "voice_prices._cli:cli"
+
+[project.urls]
+Homepage = "https://github.com/mahimailabs/voice-prices"
+Source = "https://github.com/mahimailabs/voice-prices"
+Changelog = "https://github.com/mahimailabs/voice-prices/releases"
+
+[tool.uv.build-backend]
+module-name = "voice_prices"
+module-root = ""

voice_prices-0.0.1/voice_prices/__init__.py

@@ -0,0 +1,94 @@
+from __future__ import annotations as _annotations
+
+from datetime import datetime
+from importlib.metadata import version as _metadata_version
+from typing import Any, overload
+
+from . import data_snapshot, types
+from .types import Usage
+from .update_prices import UpdatePrices, wait_prices_updated_async, wait_prices_updated_sync
+
+__version__ = _metadata_version('voice_prices')
+__all__ = 'Usage', 'calc_price', 'UpdatePrices', 'wait_prices_updated_sync', 'wait_prices_updated_async', '__version__'
+
+
+@overload
+def calc_price(
+    usage: types.AbstractUsage,
+    model_ref: str,
+    *,
+    provider_id: types.ProviderID | str | None = None,
+    genai_request_timestamp: datetime | None = None,
+) -> types.PriceCalculation: ...
+
+
+@overload
+def calc_price(
+    usage: types.AbstractUsage,
+    model_ref: str,
+    *,
+    provider_api_url: str | None = None,
+    genai_request_timestamp: datetime | None = None,
+) -> types.PriceCalculation: ...
+
+
+def calc_price(
+    usage: types.AbstractUsage,
+    model_ref: str,
+    *,
+    provider_id: types.ProviderID | str | None = None,
+    provider_api_url: str | None = None,
+    genai_request_timestamp: datetime | None = None,
+) -> types.PriceCalculation:
+    """Calculate the price of an LLM API call.
+
+    Either `provider_id` or `provider_api_url` should be provided, but not both. If neither are provided,
+    we try to find the most suitable provider based on the model reference.
+
+    Args:
+        usage: The usage to calculate the price for.
+        model_ref: A reference to the model used, this method will try to match this to a specific model.
+        provider_id: The ID of the provider to calculate the price for.
+        provider_api_url: The API URL of the provider to calculate the price for.
+        genai_request_timestamp: The timestamp of the request to the GenAI service, use `None` to use the current time.
+
+    Returns:
+        The price calculation details.
+    """
+    return data_snapshot.get_snapshot().calc(usage, model_ref, provider_id, provider_api_url, genai_request_timestamp)
+
+
+@overload
+def extract_usage(
+    response_data: Any, *, provider_id: types.ProviderID | str, api_flavor: str = 'default'
+) -> types.ExtractedUsage: ...
+
+
+@overload
+def extract_usage(
+    response_data: Any, *, provider_api_url: str, api_flavor: str = 'default'
+) -> types.ExtractedUsage: ...
+
+
+def extract_usage(
+    response_data: Any,
+    *,
+    provider_id: types.ProviderID | str | None = None,
+    provider_api_url: str | None = None,
+    api_flavor: str = 'default',
+) -> types.ExtractedUsage:
+    """Extract usage information from a response.
+
+    One of `provider_id` or `provider_api_url` is required.
+
+    Args:
+        response_data: The response data to extract usage information from.
+        provider: The provider to extract usage information for.
+        provider_id: The ID of the provider to extract usage information for.
+        provider_api_url: The API URL of the provider to extract usage information for.
+        api_flavor: The API flavor of the provider to extract usage information for.
+
+    Returns:
+        The extracted usage information, model ref and provider used.
+    """
+    return data_snapshot.get_snapshot().extract_usage(response_data, provider_id, provider_api_url, api_flavor)

voice_prices-0.0.1/voice_prices/__main__.py

@@ -0,0 +1,6 @@
+"""This means `python -m voice_prices` should run the CLI."""
+
+from ._cli import cli
+
+if __name__ == '__main__':
+    cli()