txaion-model-pricing 0.1.0__tar.gz

txaion_model_pricing-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Txaion LLC
+
+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.

txaion_model_pricing-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include scripts/update_prices.py
+include README.zh-TW.md

txaion_model_pricing-0.1.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: txaion-model-pricing
+Version: 0.1.0
+Summary: Cross-provider AI model pricing for Python
+Author: Txaion LLC
+License-Expression: MIT
+Project-URL: Homepage, https://txaion.com
+Project-URL: Repository, https://github.com/Txaion/txaion-model-pricing
+Project-URL: Upstream-Data, https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: orjson<4,>=3.10
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Requires-Dist: ruff<1,>=0.12; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://txaion.com">
+    <img
+      src="https://static.txaion.com/product/model-price/model-price-tp.png"
+      alt="Txaion"
+      width="360"
+    >
+  </a>
+</p>
+
+<h1 align="center">Txaion Model Pricing</h1>
+
+<p align="center">
+  Lightweight, cross-provider model pricing for Python.
+</p>
+
+<p align="center">
+  <strong>English</strong> |
+  <a href="README.zh-TW.md">繁體中文</a>
+</p>
+
+`Txaion Model Pricing` is a lightweight Python package for querying
+cross-provider model information and calculating USD costs for input, output,
+and cached-input tokens.
+
+Developed and maintained by [Txaion](https://txaion.com).
+
+The current version is `0.1.0` and requires Python 3.10 or later.
+
+## Installation
+
+Install the package from the project directory:
+
+```bash
+python -m pip install .
+```
+
+Install the development dependencies for testing and building:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+from txaion_model_pricing import calculate_cost, count_models, get_model_details
+
+print(count_models())
+
+input_cost = calculate_cost("gpt-4o", 1_000_000, "input")
+output_cost = calculate_cost("gpt-4o", 1_000_000, "output")
+cached_cost = calculate_cost("gpt-4o", 1_000_000, "cached")
+
+print(input_cost)   # Decimal("2.5000000")
+print(output_cost)  # Decimal("10.00000")
+print(cached_cost)  # Decimal("1.25000000")
+
+details = get_model_details("gpt-4o")
+print(details["max_input_tokens"])
+```
+
+All costs are returned as `decimal.Decimal` values. The package does not round
+results or perform currency conversion.
+
+## Public API
+
+### `count_models() -> int`
+
+Returns the number of models in the bundled snapshot. Metadata entries such as
+`sample_spec` are excluded.
+
+### `calculate_cost(model, tokens, token_type) -> Decimal`
+
+Calculates the USD cost using the model's per-token price:
+
+- `input` maps to `input_cost_per_token`
+- `output` maps to `output_cost_per_token`
+- `cached` maps to `cache_read_input_token_cost`
+
+`tokens` must be a non-negative integer. If the requested price field is
+unavailable, the package does not treat the cost as zero or fall back to a
+different price.
+
+### `get_model_details(model) -> dict`
+
+Returns a deep copy of the model data. Modifying the returned value does not
+affect the package's internal cache.
+
+## Error handling
+
+All domain-specific exceptions inherit from `ModelPriceError`:
+
+```python
+from txaion_model_pricing import (
+    InvalidTokenCountError,
+    InvalidTokenTypeError,
+    NotFound,
+    PriceUnavailableError,
+    calculate_cost,
+)
+
+try:
+    cost = calculate_cost("unknown-model", 1_000, "input")
+except NotFound:
+    ...
+except PriceUnavailableError:
+    ...
+except (InvalidTokenCountError, InvalidTokenTypeError):
+    ...
+```
+
+## Price data
+
+The package includes a pinned snapshot of the
+[LiteLLM model price and context-window data](https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json).
+The source commit, retrieval time, and SHA-256 checksum are recorded in
+`src/txaion_model_pricing/data_source.json`. See `THIRD_PARTY_NOTICES.md` for
+third-party attribution and licensing information.
+
+Maintainers must specify an immutable commit SHA or tag when updating the
+snapshot:
+
+```bash
+python scripts/update_prices.py <commit-or-tag>
+```
+
+The update tool downloads and validates the JSON before atomically replacing
+the snapshot and its metadata. Moving refs such as `main`, `master`, and
+`latest` are rejected.
+
+## Limitations
+
+- Version `0.1.0` only calculates token-based input, output, and cached-input
+  costs.
+- Image, audio, search, tool-call, session, and storage pricing are not
+  supported by `calculate_cost()`.
+- Model providers may change their prices at any time. Results depend on the
+  bundled snapshot and may not match current provider pricing. Verify official
+  provider prices before using the results for billing or budget enforcement.
+
+## Development
+
+```bash
+ruff check .
+pytest
+python -m build
+```
+
+## License
+
+This project and the vendored LiteLLM data are redistributed under the MIT
+License. See `LICENSE` and `THIRD_PARTY_NOTICES.md` for details.

txaion_model_pricing-0.1.0/README.md

@@ -0,0 +1,153 @@
+<p align="center">
+  <a href="https://txaion.com">
+    <img
+      src="https://static.txaion.com/product/model-price/model-price-tp.png"
+      alt="Txaion"
+      width="360"
+    >
+  </a>
+</p>
+
+<h1 align="center">Txaion Model Pricing</h1>
+
+<p align="center">
+  Lightweight, cross-provider model pricing for Python.
+</p>
+
+<p align="center">
+  <strong>English</strong> |
+  <a href="README.zh-TW.md">繁體中文</a>
+</p>
+
+`Txaion Model Pricing` is a lightweight Python package for querying
+cross-provider model information and calculating USD costs for input, output,
+and cached-input tokens.
+
+Developed and maintained by [Txaion](https://txaion.com).
+
+The current version is `0.1.0` and requires Python 3.10 or later.
+
+## Installation
+
+Install the package from the project directory:
+
+```bash
+python -m pip install .
+```
+
+Install the development dependencies for testing and building:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+from txaion_model_pricing import calculate_cost, count_models, get_model_details
+
+print(count_models())
+
+input_cost = calculate_cost("gpt-4o", 1_000_000, "input")
+output_cost = calculate_cost("gpt-4o", 1_000_000, "output")
+cached_cost = calculate_cost("gpt-4o", 1_000_000, "cached")
+
+print(input_cost)   # Decimal("2.5000000")
+print(output_cost)  # Decimal("10.00000")
+print(cached_cost)  # Decimal("1.25000000")
+
+details = get_model_details("gpt-4o")
+print(details["max_input_tokens"])
+```
+
+All costs are returned as `decimal.Decimal` values. The package does not round
+results or perform currency conversion.
+
+## Public API
+
+### `count_models() -> int`
+
+Returns the number of models in the bundled snapshot. Metadata entries such as
+`sample_spec` are excluded.
+
+### `calculate_cost(model, tokens, token_type) -> Decimal`
+
+Calculates the USD cost using the model's per-token price:
+
+- `input` maps to `input_cost_per_token`
+- `output` maps to `output_cost_per_token`
+- `cached` maps to `cache_read_input_token_cost`
+
+`tokens` must be a non-negative integer. If the requested price field is
+unavailable, the package does not treat the cost as zero or fall back to a
+different price.
+
+### `get_model_details(model) -> dict`
+
+Returns a deep copy of the model data. Modifying the returned value does not
+affect the package's internal cache.
+
+## Error handling
+
+All domain-specific exceptions inherit from `ModelPriceError`:
+
+```python
+from txaion_model_pricing import (
+    InvalidTokenCountError,
+    InvalidTokenTypeError,
+    NotFound,
+    PriceUnavailableError,
+    calculate_cost,
+)
+
+try:
+    cost = calculate_cost("unknown-model", 1_000, "input")
+except NotFound:
+    ...
+except PriceUnavailableError:
+    ...
+except (InvalidTokenCountError, InvalidTokenTypeError):
+    ...
+```
+
+## Price data
+
+The package includes a pinned snapshot of the
+[LiteLLM model price and context-window data](https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json).
+The source commit, retrieval time, and SHA-256 checksum are recorded in
+`src/txaion_model_pricing/data_source.json`. See `THIRD_PARTY_NOTICES.md` for
+third-party attribution and licensing information.
+
+Maintainers must specify an immutable commit SHA or tag when updating the
+snapshot:
+
+```bash
+python scripts/update_prices.py <commit-or-tag>
+```
+
+The update tool downloads and validates the JSON before atomically replacing
+the snapshot and its metadata. Moving refs such as `main`, `master`, and
+`latest` are rejected.
+
+## Limitations
+
+- Version `0.1.0` only calculates token-based input, output, and cached-input
+  costs.
+- Image, audio, search, tool-call, session, and storage pricing are not
+  supported by `calculate_cost()`.
+- Model providers may change their prices at any time. Results depend on the
+  bundled snapshot and may not match current provider pricing. Verify official
+  provider prices before using the results for billing or budget enforcement.
+
+## Development
+
+```bash
+ruff check .
+pytest
+python -m build
+```
+
+## License
+
+This project and the vendored LiteLLM data are redistributed under the MIT
+License. See `LICENSE` and `THIRD_PARTY_NOTICES.md` for details.

txaion_model_pricing-0.1.0/README.zh-TW.md

@@ -0,0 +1,148 @@
+<p align="center">
+  <a href="https://txaion.com">
+    <img
+      src="https://static.txaion.com/product/model-price/model-price-tp.png"
+      alt="Txaion"
+      width="360"
+    >
+  </a>
+</p>
+
+<h1 align="center">Txaion Model Pricing</h1>
+
+<p align="center">
+  輕量、跨供應商的 Python 模型價格套件。
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <strong>繁體中文</strong>
+</p>
+
+`Txaion Model Pricing` 是一個輕量的 Python 套件，用來查詢跨供應商模型
+資訊，並依 token 數量計算 input、output 與 cached input 的美元成本。
+
+本專案由 [Txaion](https://txaion.com) 開發與維護。
+
+目前版本為 `0.1.0`，支援 Python 3.10 以上版本。
+
+## 安裝
+
+從本專案目錄安裝：
+
+```bash
+python -m pip install .
+```
+
+開發環境可安裝測試與建置工具：
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## 快速開始
+
+```python
+from txaion_model_pricing import (
+    calculate_cost,
+    count_models,
+    get_model_details,
+)
+
+print(count_models())
+
+input_cost = calculate_cost("gpt-4o", 1_000_000, "input")
+output_cost = calculate_cost("gpt-4o", 1_000_000, "output")
+cached_cost = calculate_cost("gpt-4o", 1_000_000, "cached")
+
+print(input_cost)   # Decimal("2.5000000")
+print(output_cost)  # Decimal("10.00000")
+print(cached_cost)  # Decimal("1.25000000")
+
+details = get_model_details("gpt-4o")
+print(details["max_input_tokens"])
+```
+
+所有成本均以 `decimal.Decimal` 回傳；套件不會自行四捨五入或轉換貨幣。
+
+## 公開 API
+
+### `count_models() -> int`
+
+回傳快照中的模型數量。`sample_spec` 等資料格式描述不會被計入。
+
+### `calculate_cost(model, tokens, token_type) -> Decimal`
+
+依模型的每 token 價格計算美元成本：
+
+- `input` 對應 `input_cost_per_token`
+- `output` 對應 `output_cost_per_token`
+- `cached` 對應 `cache_read_input_token_cost`
+
+`tokens` 必須是非負整數。價格資料缺少指定欄位時，套件不會將成本視為零，
+也不會退回其他價格。
+
+### `get_model_details(model) -> dict`
+
+回傳模型資料的深層副本。修改回傳值不會污染套件內部快取。
+
+## 錯誤處理
+
+所有領域例外都繼承自 `ModelPriceError`：
+
+```python
+from txaion_model_pricing import (
+    InvalidTokenCountError,
+    InvalidTokenTypeError,
+    NotFound,
+    PriceUnavailableError,
+    calculate_cost,
+)
+
+try:
+    cost = calculate_cost("unknown-model", 1_000, "input")
+except NotFound:
+    ...
+except PriceUnavailableError:
+    ...
+except (InvalidTokenCountError, InvalidTokenTypeError):
+    ...
+```
+
+## 價格資料
+
+內附資料是
+[LiteLLM 模型價格與 context-window 資料](https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json)
+的固定快照。來源 commit、擷取時間與 SHA-256 記錄在
+`src/txaion_model_pricing/data_source.json`，第三方授權資訊請見
+`THIRD_PARTY_NOTICES.md`。
+
+維護者更新資料時必須指定固定 commit SHA 或 tag：
+
+```bash
+python scripts/update_prices.py <commit-or-tag>
+```
+
+更新工具會先下載及驗證 JSON，再原子替換資料與 metadata；`main`、`master`
+及 `latest` 等浮動 ref 會被拒絕。
+
+## 限制
+
+- `0.1.0` 僅計算 token-based input、output 與 cached input 成本。
+- 圖片、音訊、搜尋、工具呼叫、工作階段及儲存空間等計價方式尚未納入
+  `calculate_cost()`。
+- 模型供應商可能隨時調整價格；本套件結果取決於內附快照，不保證與供應商
+  當下價格一致。進行實際帳務或預算控管前，請核對供應商官方價格。
+
+## 開發
+
+```bash
+ruff check .
+pytest
+python -m build
+```
+
+## 授權
+
+本專案及 vendored LiteLLM 資料皆依 MIT License 再散布。詳細內容請見
+`LICENSE` 與 `THIRD_PARTY_NOTICES.md`。

txaion_model_pricing-0.1.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# Third-Party Notices
+
+## LiteLLM model price data
+
+`src/txaion_model_pricing/model_prices_and_context_window.json` is a vendored
+snapshot of the LiteLLM model price and context-window data:
+
+- Source: https://github.com/BerriAI/litellm
+- Upstream file:
+  https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
+- Upstream copyright: Copyright (c) 2023 Berri AI
+- License: MIT
+
+The full LiteLLM license is available at:
+https://github.com/BerriAI/litellm/blob/main/LICENSE
+
+The snapshot is redistributed under the MIT License. See `LICENSE` for the
+license text that applies to this project.

txaion_model_pricing-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "txaion-model-pricing"
+version = "0.1.0"
+description = "Cross-provider AI model pricing for Python"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE", "THIRD_PARTY_NOTICES.md"]
+authors = [
+    { name = "Txaion LLC" },
+]
+dependencies = [
+    "orjson>=3.10,<4",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.2,<2",
+    "pytest>=8,<9",
+    "ruff>=0.12,<1",
+]
+
+[project.urls]
+Homepage = "https://txaion.com"
+Repository = "https://github.com/Txaion/txaion-model-pricing"
+Upstream-Data = "https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+txaion_model_pricing = ["*.json", "py.typed"]
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]