> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/streaming-api/pricing.md).

# Pricing & Access

## The add-on

The Streaming API is available as an add-on to any Terra base plan for **$99/month**. Activate it from the dashboard — either on the Streaming page itself, or under **Settings → Plans → Additional Products**.

Without the add-on active, all streaming authentication endpoints return `403 Forbidden` — no producer, consumer, or test-user tokens can be minted, so streaming (including the synthetic-data test mode) requires an active subscription.

## Credits

Usage is measured in **credits**. Your subscription includes **20,000 credits per month** — beyond that, credits are billed at **$0.005 each** at the end of each billing cycle, with volume discounts at high usage ($0.003 per credit past 1,000,000 credits in a month). Included credits reset each billing cycle and do not roll over. Overage is billed, never blocked — streams are not cut off mid-session.

| Usage                                                                                   | Credits                            |
| --------------------------------------------------------------------------------------- | ---------------------------------- |
| **Active streaming user** — a user who streams at least one event in the billing period | 1,000 credits ($5)                 |
| **Included events** — each active user's first 16,000 delivered events in the period    | Free                               |
| **Additional events** — each delivered event beyond a user's included 16,000            | 1/16 credit (16 events = 1 credit) |
| Synthetic test users (dashboard test mode)                                              | Free                               |

The included 20,000 credits cover **20 active streaming users per month** (each within their included events), or any mix of users and event overage.

{% hint style="info" %}
An **event** is one real-time message delivered to your consumer connection — typically about one per second per active stream. The per-user event allowance is applied per user: one heavy user cannot consume another user's unused headroom. Fractional credits round down in your favour, and duplicate deliveries are deduplicated before counting.
{% endhint %}

### What this looks like in practice

* At roughly one event per second, a user's included 16,000 events cover about **4.5 hours of live streaming per month**.
* Each additional hour of continuous per-second streaming is about 225 credits (**≈ $1.13/hour**).
* A team of 20 users doing weekly one-hour live sessions (≈ 4 hours each/month) fits entirely inside the included 20,000 credits: **$99/month total**.

## Access states

* **Add-on active** — full access: producer/consumer/SDK token minting, live streaming, replay, test mode.
* **Add-on not active** — token minting returns `403 Forbidden`. Existing sessions end when their tokens expire; nothing else about your Terra plan is affected.