tovano 1.0.0__tar.gz

tovano-1.0.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+.DS_Store
+.env

tovano-1.0.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 1.0.0 (2026-11-16)
+
+First release.
+
+- `Tovano` (sync) and `AsyncTovano` (asyncio) clients with the full `/v1` API: models, runs (create, get, list, iterate, wait, run), chat completions with streaming, balance, usage.
+- Default base URL `https://api.tovano.ai`.
+- Typed response objects (dicts with attribute access) and typed errors, including `InsufficientCreditsError` and `SpendLimitReachedError` (402) and `RateLimitError` with `retry_after`.
+- Retries with exponential backoff and jitter, `Retry-After` honoured, the same `Idempotency-Key` on every attempt.
+- Customer tags per call or per client (`with_options`).
+- Webhook verification with timestamp tolerance and multiple signatures; `webhooks.sign()` for tests.
+- Python 3.9 to 3.14. One dependency: `httpx`. Fully typed (`py.typed`, mypy strict).
+- `Balance.balance_credits` and usage `succeeded` / `all` counts.

tovano-1.0.0/LICENSE

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

tovano-1.0.0/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.5
+Name: tovano
+Version: 1.0.0
+Summary: Official Python client for the Tovano API: one API key, one balance and one invoice for image, video, audio and text models.
+Project-URL: Homepage, https://tovano.ai
+Project-URL: Documentation, https://tovano.ai/docs/sdk
+Project-URL: Repository, https://github.com/tovanoai/tovano-python
+Project-URL: Issues, https://github.com/tovanoai/tovano-python/issues
+Project-URL: Changelog, https://github.com/tovanoai/tovano-python/blob/main/CHANGELOG.md
+Author-email: Tovano <support@tovano.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,api,image generation,llm,openai compatible,sdk,text to speech,tovano,video generation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.25
+Description-Content-Type: text/markdown
+
+# tovano
+
+The official Python client for [Tovano](https://tovano.ai): one API key, one prepaid balance and one invoice for image, video, audio and text models, charged per unit.
+
+| | |
+|---|---|
+| Python | 3.9 to 3.14 |
+| Clients | `Tovano` (sync) and `AsyncTovano` (asyncio) |
+| Dependencies | `httpx` only |
+| Built in | Retries with backoff, idempotency keys, streaming, typed errors and objects, webhook verification |
+
+## Install
+
+```bash
+pip install "git+https://github.com/tovanoai/tovano-python"
+```
+
+```bash
+uv add tovano
+```
+
+Or straight from GitHub:
+
+```bash
+pip install git+https://github.com/tovanoai/tovano-python
+```
+
+## Quick start
+
+```python
+from tovano import Tovano, format_usd
+
+client = Tovano()  # reads TOVANO_API_KEY
+
+run = client.runs.run(
+    model="image/flux-1.1-pro",
+    input={"prompt": "Product photo of a blue ceramic mug", "n": 2},
+)
+print(run.status, run.units, format_usd(run.charged_micro))  # completed 2 $0.096
+print(run.output.images[0].url)
+```
+
+Money is always an integer number of micro-dollars (1 USD = 1_000_000) in fields ending in `_micro`. `format_usd` turns it into text; `usd_to_micro` and `micro_to_usd` convert exactly (with `Decimal`).
+
+Responses are typed objects that are also dicts: `run.status` and `run["status"]` both work, and `json.dumps(run)` works.
+
+## Try it without a key
+
+Every example in [`examples/`](./examples) runs in **offline mode** when `TOVANO_API_KEY` is not set: a simulated API answers with the same shapes and prices, at no cost.
+
+```bash
+git clone https://github.com/tovanoai/tovano-python && cd tovano-python && uv sync
+uv run python examples/quickstart.py
+```
+
+| Example | Shows |
+|---|---|
+| `quickstart.py` | Balance, an image run, charge |
+| `models.py` | The catalogue with prices |
+| `chat.py` / `chat_stream.py` | OpenAI-compatible chat, with streaming |
+| `async_batch.py` | Several models at once with asyncio |
+| `agent_job.py` | An agent job with one charge per step |
+| `customer_usage.py` | Customer tags and spend per customer |
+| `errors.py` | Typed errors, retries, failed runs |
+| `webhook_server.py` | Receive and verify webhooks (standard library) |
+
+## Client options
+
+```python
+client = Tovano(
+    api_key="tvn_live_...",  # default: TOVANO_API_KEY
+    base_url="https://api.tovano.ai",  # default: TOVANO_BASE_URL, else https://api.tovano.ai
+    max_retries=2,  # connection errors, timeouts, 408, 429, 5xx
+    timeout=60.0,  # seconds per attempt
+    customer="acme",  # default customer tag for every call
+    webhook_secret="whsec_...",  # default: TOVANO_WEBHOOK_SECRET
+    app_info="my-app/1.2.0",
+    http_client=None,  # your own httpx.Client (proxies, transports)
+)
+```
+
+Every method also takes per-call keyword options: `idempotency_key`, `customer` (header), `extra_headers`, `timeout`, `max_retries`. Use `with Tovano() as client:` or `client.close()` to free connections.
+
+## Async
+
+```python
+import asyncio
+from tovano import AsyncTovano
+
+
+async def main():
+    async with AsyncTovano() as client:
+        a, b = await asyncio.gather(
+            client.runs.run(model="image/flux-1.1-pro", input={"prompt": "Mug"}),
+            client.runs.run(model="audio/eleven-multilingual-v2", input={"text": "Hello"}),
+        )
+
+
+asyncio.run(main())
+```
+
+`AsyncTovano` has the same methods as `Tovano`, as coroutines.
+
+## Runs
+
+```python
+run = client.runs.create(
+    model="video/kling-2.1-pro",
+    input={"prompt": "Waves on a beach", "duration": 5},
+    webhook_url="https://example.com/tovano-webhook",  # optional
+)
+done = client.runs.wait(run.id, timeout=120)
+if done.status == "failed":
+    print(done.error.message, "(not charged)")
+```
+
+| Method | What it does |
+|---|---|
+| `runs.create(model=, input=, customer=, webhook_url=)` | Starts a run. POSTs get a random `Idempotency-Key`, so a retry never runs twice. |
+| `runs.get(run_id)` | Status, output, units and charge |
+| `runs.wait(run_id, interval=0.5, timeout=600)` | Polls until done. Raises `RunTimeoutError`. |
+| `runs.run(..., raise_on_failure=False)` | `create` + `wait` |
+| `runs.list(status=, model=, customer=, type=, limit=, cursor=)` | One `Page` (iterable), newest first |
+| `runs.iterate(**filters)` | Every match, paging for you |
+
+## Chat (OpenAI-compatible)
+
+```python
+res = client.chat.completions.create(
+    model="text/gpt-4.1-mini",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(res.choices[0].message.content, res.usage.total_tokens, res.tovano.charged_micro)
+
+with client.chat.completions.create(model="text/gpt-4.1-mini", messages=messages, stream=True) as stream:
+    for chunk in stream:
+        if chunk.choices:
+            print(chunk.choices[0].delta.content or "", end="")
+    result = stream.final_result()  # content, finish_reason, usage, tovano
+```
+
+Leaving the `with` block early stops the stream; tokens already produced are charged. `stream.run_id` is the run that records the call. Async: `async for chunk in await client.chat.completions.create(..., stream=True)`.
+
+Any OpenAI client works too: set its base URL to `https://api.tovano.ai/v1` and use your Tovano key.
+
+## Models, balance and usage
+
+```python
+models = client.models.list()  # type, unit, prices
+model = client.models.get("image/flux-1.1-pro")  # plus input_schema (JSON Schema)
+balance = client.balance()  # available_micro, reserved_micro, spent_this_month_micro
+usage = client.usage(group_by="customer", from_="2026-11-01")
+```
+
+`group_by` is `model`, `customer`, `day`, `project` or `key`. `from_` has an underscore because `from` is a Python keyword.
+
+## Customer tags
+
+```python
+client.runs.create(model=model, input=inp, customer="acme")  # on a run or chat call
+client.balance(customer="acme")  # any call, as an option
+acme = client.with_options(customer="acme")  # a client that tags every call
+```
+
+## Webhooks
+
+```python
+from tovano import webhooks, WebhookVerificationError
+
+run = webhooks.construct_event(
+    raw_body,  # the raw bytes, as received
+    request.headers["Tovano-Signature"],
+    os.environ["TOVANO_WEBHOOK_SECRET"],
+)
+```
+
+The header is `t=<unix>,v1=<hex HMAC-SHA256 of "t.body">`. Signatures older than 5 minutes are rejected (`tolerance=` changes it). `webhooks.verify()` returns a bool; `webhooks.sign()` builds a header for your tests. `client.webhooks.*` uses the client's `webhook_secret`.
+
+## Errors
+
+Every failed call raises a `TovanoError` with `status`, `code`, `type`, `param`, `request_id` and `headers`.
+
+| Class | Status | Code | Meaning |
+|---|---|---|---|
+| `AuthenticationError` | 401 | `invalid_api_key` | Missing, invalid or revoked key |
+| `InsufficientCreditsError` | 402 | `insufficient_credits` | Add credits in the dashboard |
+| `SpendLimitReachedError` | 402 | `spend_limit_reached` | Monthly spend limit reached |
+| `PermissionDeniedError` | 403 | `forbidden` | |
+| `NotFoundError` | 404 | `not_found` | Unknown model or run |
+| `ConflictError` | 409 | `conflict` | Idempotency-Key reused with another body |
+| `InvalidRequestError` | 422 | `invalid_request` | `param` names the field |
+| `RateLimitError` | 429 | `rate_limited` | Retried for you; `retry_after` in seconds |
+| `InternalServerError` | 5xx | `internal_error` | Retried for you |
+| `ProviderError` | 502 | `provider_error` | The model provider failed; not charged |
+| `APIConnectionError` / `APITimeoutError` | 0 | | No response |
+| `RunTimeoutError` | | `run_timeout` | `runs.wait()` gave up; the run keeps running |
+| `RunFailedError` | | | `runs.run(raise_on_failure=True)` |
+
+`InsufficientCreditsError` and `SpendLimitReachedError` both subclass `PaymentRequiredError`.
+
+**Retries:** connection errors, timeouts, 408, 429 and 5xx are retried `max_retries` times with exponential backoff and jitter. `Retry-After` is honoured up to 60 seconds. The same `Idempotency-Key` is sent on every attempt.
+
+## Development
+
+```bash
+uv sync
+uv run pytest        # unit tests, plus integration tests against a local Tovano server when available
+uv run mypy
+uv run ruff check .
+uv build
+```
+
+## License
+
+MIT

tovano-1.0.0/README.md

@@ -0,0 +1,215 @@
+# tovano
+
+The official Python client for [Tovano](https://tovano.ai): one API key, one prepaid balance and one invoice for image, video, audio and text models, charged per unit.
+
+| | |
+|---|---|
+| Python | 3.9 to 3.14 |
+| Clients | `Tovano` (sync) and `AsyncTovano` (asyncio) |
+| Dependencies | `httpx` only |
+| Built in | Retries with backoff, idempotency keys, streaming, typed errors and objects, webhook verification |
+
+## Install
+
+```bash
+pip install "git+https://github.com/tovanoai/tovano-python"
+```
+
+```bash
+uv add tovano
+```
+
+Or straight from GitHub:
+
+```bash
+pip install git+https://github.com/tovanoai/tovano-python
+```
+
+## Quick start
+
+```python
+from tovano import Tovano, format_usd
+
+client = Tovano()  # reads TOVANO_API_KEY
+
+run = client.runs.run(
+    model="image/flux-1.1-pro",
+    input={"prompt": "Product photo of a blue ceramic mug", "n": 2},
+)
+print(run.status, run.units, format_usd(run.charged_micro))  # completed 2 $0.096
+print(run.output.images[0].url)
+```
+
+Money is always an integer number of micro-dollars (1 USD = 1_000_000) in fields ending in `_micro`. `format_usd` turns it into text; `usd_to_micro` and `micro_to_usd` convert exactly (with `Decimal`).
+
+Responses are typed objects that are also dicts: `run.status` and `run["status"]` both work, and `json.dumps(run)` works.
+
+## Try it without a key
+
+Every example in [`examples/`](./examples) runs in **offline mode** when `TOVANO_API_KEY` is not set: a simulated API answers with the same shapes and prices, at no cost.
+
+```bash
+git clone https://github.com/tovanoai/tovano-python && cd tovano-python && uv sync
+uv run python examples/quickstart.py
+```
+
+| Example | Shows |
+|---|---|
+| `quickstart.py` | Balance, an image run, charge |
+| `models.py` | The catalogue with prices |
+| `chat.py` / `chat_stream.py` | OpenAI-compatible chat, with streaming |
+| `async_batch.py` | Several models at once with asyncio |
+| `agent_job.py` | An agent job with one charge per step |
+| `customer_usage.py` | Customer tags and spend per customer |
+| `errors.py` | Typed errors, retries, failed runs |
+| `webhook_server.py` | Receive and verify webhooks (standard library) |
+
+## Client options
+
+```python
+client = Tovano(
+    api_key="tvn_live_...",  # default: TOVANO_API_KEY
+    base_url="https://api.tovano.ai",  # default: TOVANO_BASE_URL, else https://api.tovano.ai
+    max_retries=2,  # connection errors, timeouts, 408, 429, 5xx
+    timeout=60.0,  # seconds per attempt
+    customer="acme",  # default customer tag for every call
+    webhook_secret="whsec_...",  # default: TOVANO_WEBHOOK_SECRET
+    app_info="my-app/1.2.0",
+    http_client=None,  # your own httpx.Client (proxies, transports)
+)
+```
+
+Every method also takes per-call keyword options: `idempotency_key`, `customer` (header), `extra_headers`, `timeout`, `max_retries`. Use `with Tovano() as client:` or `client.close()` to free connections.
+
+## Async
+
+```python
+import asyncio
+from tovano import AsyncTovano
+
+
+async def main():
+    async with AsyncTovano() as client:
+        a, b = await asyncio.gather(
+            client.runs.run(model="image/flux-1.1-pro", input={"prompt": "Mug"}),
+            client.runs.run(model="audio/eleven-multilingual-v2", input={"text": "Hello"}),
+        )
+
+
+asyncio.run(main())
+```
+
+`AsyncTovano` has the same methods as `Tovano`, as coroutines.
+
+## Runs
+
+```python
+run = client.runs.create(
+    model="video/kling-2.1-pro",
+    input={"prompt": "Waves on a beach", "duration": 5},
+    webhook_url="https://example.com/tovano-webhook",  # optional
+)
+done = client.runs.wait(run.id, timeout=120)
+if done.status == "failed":
+    print(done.error.message, "(not charged)")
+```
+
+| Method | What it does |
+|---|---|
+| `runs.create(model=, input=, customer=, webhook_url=)` | Starts a run. POSTs get a random `Idempotency-Key`, so a retry never runs twice. |
+| `runs.get(run_id)` | Status, output, units and charge |
+| `runs.wait(run_id, interval=0.5, timeout=600)` | Polls until done. Raises `RunTimeoutError`. |
+| `runs.run(..., raise_on_failure=False)` | `create` + `wait` |
+| `runs.list(status=, model=, customer=, type=, limit=, cursor=)` | One `Page` (iterable), newest first |
+| `runs.iterate(**filters)` | Every match, paging for you |
+
+## Chat (OpenAI-compatible)
+
+```python
+res = client.chat.completions.create(
+    model="text/gpt-4.1-mini",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+print(res.choices[0].message.content, res.usage.total_tokens, res.tovano.charged_micro)
+
+with client.chat.completions.create(model="text/gpt-4.1-mini", messages=messages, stream=True) as stream:
+    for chunk in stream:
+        if chunk.choices:
+            print(chunk.choices[0].delta.content or "", end="")
+    result = stream.final_result()  # content, finish_reason, usage, tovano
+```
+
+Leaving the `with` block early stops the stream; tokens already produced are charged. `stream.run_id` is the run that records the call. Async: `async for chunk in await client.chat.completions.create(..., stream=True)`.
+
+Any OpenAI client works too: set its base URL to `https://api.tovano.ai/v1` and use your Tovano key.
+
+## Models, balance and usage
+
+```python
+models = client.models.list()  # type, unit, prices
+model = client.models.get("image/flux-1.1-pro")  # plus input_schema (JSON Schema)
+balance = client.balance()  # available_micro, reserved_micro, spent_this_month_micro
+usage = client.usage(group_by="customer", from_="2026-11-01")
+```
+
+`group_by` is `model`, `customer`, `day`, `project` or `key`. `from_` has an underscore because `from` is a Python keyword.
+
+## Customer tags
+
+```python
+client.runs.create(model=model, input=inp, customer="acme")  # on a run or chat call
+client.balance(customer="acme")  # any call, as an option
+acme = client.with_options(customer="acme")  # a client that tags every call
+```
+
+## Webhooks
+
+```python
+from tovano import webhooks, WebhookVerificationError
+
+run = webhooks.construct_event(
+    raw_body,  # the raw bytes, as received
+    request.headers["Tovano-Signature"],
+    os.environ["TOVANO_WEBHOOK_SECRET"],
+)
+```
+
+The header is `t=<unix>,v1=<hex HMAC-SHA256 of "t.body">`. Signatures older than 5 minutes are rejected (`tolerance=` changes it). `webhooks.verify()` returns a bool; `webhooks.sign()` builds a header for your tests. `client.webhooks.*` uses the client's `webhook_secret`.
+
+## Errors
+
+Every failed call raises a `TovanoError` with `status`, `code`, `type`, `param`, `request_id` and `headers`.
+
+| Class | Status | Code | Meaning |
+|---|---|---|---|
+| `AuthenticationError` | 401 | `invalid_api_key` | Missing, invalid or revoked key |
+| `InsufficientCreditsError` | 402 | `insufficient_credits` | Add credits in the dashboard |
+| `SpendLimitReachedError` | 402 | `spend_limit_reached` | Monthly spend limit reached |
+| `PermissionDeniedError` | 403 | `forbidden` | |
+| `NotFoundError` | 404 | `not_found` | Unknown model or run |
+| `ConflictError` | 409 | `conflict` | Idempotency-Key reused with another body |
+| `InvalidRequestError` | 422 | `invalid_request` | `param` names the field |
+| `RateLimitError` | 429 | `rate_limited` | Retried for you; `retry_after` in seconds |
+| `InternalServerError` | 5xx | `internal_error` | Retried for you |
+| `ProviderError` | 502 | `provider_error` | The model provider failed; not charged |
+| `APIConnectionError` / `APITimeoutError` | 0 | | No response |
+| `RunTimeoutError` | | `run_timeout` | `runs.wait()` gave up; the run keeps running |
+| `RunFailedError` | | | `runs.run(raise_on_failure=True)` |
+
+`InsufficientCreditsError` and `SpendLimitReachedError` both subclass `PaymentRequiredError`.
+
+**Retries:** connection errors, timeouts, 408, 429 and 5xx are retried `max_retries` times with exponential backoff and jitter. `Retry-After` is honoured up to 60 seconds. The same `Idempotency-Key` is sent on every attempt.
+
+## Development
+
+```bash
+uv sync
+uv run pytest        # unit tests, plus integration tests against a local Tovano server when available
+uv run mypy
+uv run ruff check .
+uv build
+```
+
+## License
+
+MIT

tovano-1.0.0/pyproject.toml

@@ -0,0 +1,67 @@
+[project]
+name = "tovano"
+version = "1.0.0"
+description = "Official Python client for the Tovano API: one API key, one balance and one invoice for image, video, audio and text models."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Tovano", email = "support@tovano.ai" }]
+requires-python = ">=3.9"
+dependencies = ["httpx>=0.25,<1"]
+keywords = ["tovano", "ai", "api", "sdk", "image generation", "video generation", "text to speech", "llm", "openai compatible"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://tovano.ai"
+Documentation = "https://tovano.ai/docs/sdk"
+Repository = "https://github.com/tovanoai/tovano-python"
+Issues = "https://github.com/tovanoai/tovano-python/issues"
+Changelog = "https://github.com/tovanoai/tovano-python/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.24", "ruff>=0.8", "mypy>=1.13", "pytest-timeout>=2.3"]
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tovano"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/tovano", "tests", "README.md", "CHANGELOG.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
+timeout = 60
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "W"]
+per-file-ignores = { "examples/*" = ["E501"] }
+ignore = ["UP006", "UP007", "UP035", "UP045", "B904", "UP037"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = ["src/tovano"]

tovano-1.0.0/src/tovano/__init__.py

@@ -0,0 +1,98 @@
+"""Official Python client for the Tovano API.
+
+One API key, one prepaid balance and one invoice for image, video, audio and text models.
+
+>>> from tovano import Tovano
+>>> client = Tovano()  # reads TOVANO_API_KEY
+>>> run = client.runs.run(model="image/flux-1.1-pro", input={"prompt": "A blue ceramic mug"})
+>>> run.status, run.charged_micro
+('completed', 48000)
+"""
+
+from . import _webhooks as webhooks
+from ._client import AsyncTovano, Tovano
+from ._errors import (
+    APIConnectionError,
+    APIError,
+    APITimeoutError,
+    AuthenticationError,
+    ConflictError,
+    InsufficientCreditsError,
+    InternalServerError,
+    InvalidRequestError,
+    NotFoundError,
+    PaymentRequiredError,
+    PermissionDeniedError,
+    ProviderError,
+    RateLimitError,
+    RunFailedError,
+    RunTimeoutError,
+    SpendLimitReachedError,
+    TovanoError,
+    WebhookVerificationError,
+)
+from ._money import MICRO_PER_USD, format_usd, micro_to_usd, usd_to_micro
+from ._streaming import AsyncChatCompletionStream, ChatCompletionStream, ChatStreamResult
+from ._types import (
+    Balance,
+    ChatCompletion,
+    ChatCompletionChunk,
+    Model,
+    OutputFile,
+    Page,
+    Price,
+    Run,
+    RunError,
+    TovanoObject,
+    Usage,
+    UsageRow,
+)
+from ._version import __version__
+
+__all__ = [
+    "__version__",
+    "Tovano",
+    "AsyncTovano",
+    "webhooks",
+    # errors
+    "TovanoError",
+    "APIError",
+    "InvalidRequestError",
+    "AuthenticationError",
+    "PaymentRequiredError",
+    "InsufficientCreditsError",
+    "SpendLimitReachedError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "RateLimitError",
+    "InternalServerError",
+    "ProviderError",
+    "APIConnectionError",
+    "APITimeoutError",
+    "RunTimeoutError",
+    "RunFailedError",
+    "WebhookVerificationError",
+    # money
+    "MICRO_PER_USD",
+    "format_usd",
+    "usd_to_micro",
+    "micro_to_usd",
+    # streaming
+    "ChatCompletionStream",
+    "AsyncChatCompletionStream",
+    "ChatStreamResult",
+    # types
+    "TovanoObject",
+    "Model",
+    "Price",
+    "Run",
+    "RunError",
+    "OutputFile",
+    "Balance",
+    "Usage",
+    "UsageRow",
+    "Page",
+    "ChatCompletion",
+    "ChatCompletionChunk",
+]