Skip to main content

llama-index-tools-treza

Treza tools for LlamaIndex. 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

pip install -U llama-index-tools-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:

export TREZA_API_KEY="treza_live_..."

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

Tools

TrezaToolSpec gives an agent five tools:

Tool What it does Cost
generate_image A picture from a prompt, optionally from reference pictures. Treza credits
generate_video A video clip from a prompt, optionally opening or ending on a picture. Treza credits
run_pipeline Runs one of your saved Treza pipelines, with new inputs if given. Treza credits
get_run Looks up a render that was still going when its tool stopped waiting. Free
get_balance The credits left on the account. Free

A finished render comes back as 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 it

from llama_index.tools.treza import TrezaToolSpec

treza = TrezaToolSpec(max_cost_usd=1.00)
print(treza.generate_video("A red fox trots through fresh snow", aspect_ratio="9:16", duration_sec=4))

Give the tools to an agent

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.anthropic import Anthropic
from llama_index.tools.treza import TrezaToolSpec

agent = FunctionAgent(
    tools=TrezaToolSpec(max_cost_usd=1.00).to_tool_list(),
    llm=Anthropic(model="claude-sonnet-5-5"),
)
response = await agent.run("Make a 4 second vertical clip of a fox in snow.")

Pass spec_functions=[...] to to_tool_list to hand over only some of the tools.

Spending

  • max_cost_usd is set in your code. 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). 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. The get-run tool 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 agent as text, so it can react. Pass raise_on_refusal=True to have them raise TrezaError 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

pip install -e . pytest
pytest

The tests run against a scripted stand-in for Treza's API.

Support

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

MIT licensed.

Metadata

Release files for llama-index-tools-treza 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for llama-index-tools-treza 0.1.0
File Size Uploaded Provenance Actions
llama_index_tools_treza-0.1.0.tar.gz 11.5 kB With provenance Details for llama_index_tools_treza-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for llama-index-tools-treza 0.1.0
File Interpreter ABI Platform Actions
llama_index_tools_treza-0.1.0-py3-none-any.whl Python 3 none any Details for llama_index_tools_treza-0.1.0-py3-none-any.whl

Total release size: 22.7 kB

Release files / llama_index_tools_treza-0.1.0.tar.gz

Download URL llama_index_tools_treza-0.1.0.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
2501246bdebc6cb0ba769f3d74edae9f46a55d4b8864fe99e44c140beeeea189
BLAKE2b-256 checksum
How to use checksums
62417088adcc231c836d99c0f821ca44ab09cc683a26cced71ffb0489aa071c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / llama_index_tools_treza-0.1.0-py3-none-any.whl

Download URL llama_index_tools_treza-0.1.0-py3-none-any.whl
Size 11.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7e459a18a0498d930c28e0fac37dcc4a2c8b3f6e720471e35818fb815bbc8f18
BLAKE2b-256 checksum
How to use checksums
c3b2e77d298c83701db6e35b1f1c12481b92a64744cc0996c4e3a9cab056ba80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for llama-index-tools-treza 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for llama_index_tools_treza-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page