Metadata-Version: 2.5
Name: langchain-treza
Version: 0.1.0
Summary: Treza tools for LangChain: generate AI pictures and videos and run Treza pipelines, with a price cap on every render.
Project-URL: Homepage, https://www.trezalabs.com
Project-URL: Repository, https://github.com/treza-labs/langchain-treza
Project-URL: Issues, https://github.com/treza-labs/langchain-treza/issues
Author-email: "Treza Labs, Inc." <hello@trezalabs.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai video,image generation,langchain,tools,treza,video generation
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: langchain-core<2,>=0.3.0
Requires-Dist: requests<3,>=2.31
Description-Content-Type: text/markdown

# langchain-treza

[Treza](https://www.trezalabs.com) tools for LangChain and LangGraph. An agent can generate AI pictures and video clips and run your saved Treza pipelines. Treza prices every render first, and a `max_cost_usd` you set stops any render that costs more, with nothing spent.

## Install

```bash
pip install -U langchain-treza
```

Create a Treza account at https://www.trezalabs.com, add credits, and make an API key at https://www.trezalabs.com/platform/api-keys with the `pipelines:read`, `pipelines:write` and `pipelines:run` permissions. Then:

```bash
export TREZA_API_KEY="treza_live_..."
```

The package is free. Renders are paid from your prepaid Treza credits; there is no subscription.

## Tools

| Tool | Name the model sees | What it does | Cost |
| --- | --- | --- | --- |
| `TrezaGenerateImage` | `treza_generate_image` | A picture from a prompt, optionally from reference pictures. | Treza credits |
| `TrezaGenerateVideo` | `treza_generate_video` | A video clip from a prompt, optionally opening or ending on a picture. | Treza credits |
| `TrezaRunPipeline` | `treza_run_pipeline` | Runs one of your saved Treza pipelines, with new inputs if given. | Treza credits |
| `TrezaGetRun` | `treza_get_run` | Looks up a render that was still going when its tool stopped waiting. | Free |
| `TrezaBalance` | `treza_balance` | The credits left on the account. | Free |

Each tool returns a JSON string. A finished render looks like this:

```json
{"url": "https://media.trezalabs.com/...mp4", "status": "success", "finished": true,
 "price_usd": 0.28, "model": "google/veo-3.1-lite", "render_seconds": 56.0,
 "run_id": "...", "pipeline_id": "pipeline_..."}
```

## Use one tool

```python
from langchain_treza import TrezaGenerateVideo

tool = TrezaGenerateVideo(max_cost_usd=1.00)
print(tool.invoke({"prompt": "A red fox trots through fresh snow", "aspect_ratio": "9:16", "duration_sec": 4}))
```

## Give the tools to an agent

```python
from langchain.agents import create_agent
from langchain_treza import TrezaToolkit

tools = TrezaToolkit(max_cost_usd=1.00).get_tools()
agent = create_agent("anthropic:claude-sonnet-5-5", tools)
agent.invoke({"messages": [{"role": "user", "content": "Make a 4 second vertical clip of a fox in snow."}]})
```

`TrezaToolkit(include_pipelines=False)` leaves out `treza_run_pipeline`.

## Spending

- `max_cost_usd` is set when you build the tool or toolkit. The model cannot see or change it, and it cannot see the API key.
- With a cap set, Treza prices the render first. If the price is higher, the tool answers "This render costs $X, over the Max cost of $Y. Nothing was spent." and starts nothing.
- With no cap (`None`, the default), a render runs at Treza's quoted price as long as the balance covers it. **Set a cap on tools you give to an agent.**
- A render never starts when the balance does not cover its price.

## Long renders

Pictures usually take under a minute and videos one to five minutes. Each tool waits up to `wait_seconds` (300 by default, 600 for pipelines). A render still going after that comes back with `"status": "running"` and its `run_id` and `pipeline_id`, not as an error, and nothing is started twice. `treza_get_run` returns the file once it is done.

## Errors

Refusals (over the cap, low balance, a bad key, a render that broke) go back to the model as text, so an agent can react. Pass `handle_tool_error=False` to have them raise `ToolException` instead.

## Network and privacy

The tools call Treza's API over HTTPS at `www.trezalabs.com`. They send the prompt and settings with your API key, and store nothing. Privacy policy: https://docs.trezalabs.com/terms-and-privacy/privacy

## Development

```bash
pip install -e . pytest langchain-tests
pytest
```

The tests run against a scripted stand-in for Treza's API and include LangChain's standard tool tests.

## Support

Issues: https://github.com/treza-labs/langchain-treza/issues · Email: hello@trezalabs.com

MIT licensed.
