> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replayfy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# AI credits

> How Replayfy AI is metered — credits per request, a monthly allowance bundled with your plan, optional top-ups, and what happens when you run low.

Everything [Replayfy AI](/platform/replayfy-ai) does — answering your questions,
running investigations, building a funnel or cohort on request, and generating
the proactive insights on your Overview — is powered by **AI credits**. This
page explains how that metering works so you can reason about cost with no
surprises.

Credits are deliberately big, round numbers rather than fractions of a cent, and
every user-facing surface talks in credits. The only rate you need to remember:

<Info>
  **≈ 100,000 credits = \$1.** Replayfy AI runs on **leading language models**,
  and each request is metered against this fixed rate — you're only ever shown
  credits, never a raw dollar figure or token count.
</Info>

## What consumes credits

Credits are spent per **AI request** — each time a model does real work on your
behalf. Every request is metered in proportion to how much work it did, so a
quick lookup costs far less than a deep multi-step investigation.

| Where credits are spent        | What triggers it                                                                                                                                                         |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Replayfy AI answers**        | Each turn you ask in the Ask AI panel or the Overview Ask bar.                                                                                                           |
| **Investigations**             | The multi-step reasoning behind a deeper answer — reading releases, funnels, crashes, and journeys to reach a conclusion.                                                |
| **AI-built funnels & cohorts** | When you ask the AI to assemble a funnel or a cohort and it drafts the definition for you.                                                                               |
| **Proactive insights**         | The Overview **Storyline**, the **Signals** analyst reads, and the worth-watching / experience-health rollups — generated on a schedule so they're ready before you ask. |

<Note>
  Proactive insights refresh on a cadence, so they spend credits even when
  nobody is actively asking. On the **Free** plan that cadence is capped (a
  daily refresh) so a workspace can't burn its whole taster allowance on
  background work it never looked at; paid tiers refresh more often.
</Note>

Watching recordings, browsing analytics, running funnels you already built, and
every other non-AI part of Replayfy cost **no credits** — only the AI features
above draw them down.

## How credits are priced

Each request is metered individually against the ≈100,000-credits-per-dollar
rate, based on the actual amount the underlying model processed for that
request. A short factual answer is cheap; a full investigation that reads
several data sources costs more.

You never have to estimate this yourself — Replayfy records the exact credit
cost of every request and rolls it up for you. Under **Settings → Billing**, the
**AI credits** section shows a per-surface breakdown over the last 30 days, so
you can see precisely how much went to Ask versus the proactive insights versus
AI-built funnels and cohorts.

<Tip>
  If one surface is consuming more than you'd like, the breakdown makes it
  obvious. Proactive insights are the usual suspect on a busy workspace — you can
  dial the AI down or off for the workspace from the settings if you'd rather
  spend credits only on questions you ask directly.
</Tip>

## Your monthly allowance

Every plan bundles a **monthly credit allowance** at no extra cost, sized so
normal usage stays comfortably inside it. The allowance scales with your plan:

| Plan           | Included AI credits / mo |
| -------------- | ------------------------ |
| **Free**       | 100,000                  |
| **Starter**    | 1,000,000                |
| **Growth**     | 3,700,000                |
| **Scale**      | 9,000,000                |
| **Business**   | 21,000,000               |
| **Enterprise** | Custom                   |

The included allowance **resets at the start of each calendar month** (UTC) — the
same reset instant as your session counter. Unused credits from the bundle don't
roll over; a fresh full allowance arrives each month.

<Info>
  AI credits are billed **separately** from your session plan. Moving up the plan
  ladder raises your monthly credit allowance along with your session volume and
  retention — see [Workspaces & billing](/platform/workspaces-and-billing) for
  the full comparison.
</Info>

## Top-ups

If a heavy month runs through the included allowance, buy more with a one-time
**top-up**. Purchased credits behave differently from the monthly bundle in the
two ways that matter:

|            | Included allowance          | Purchased credits                                    |
| ---------- | --------------------------- | ---------------------------------------------------- |
| Comes from | Bundled free with your plan | A one-time top-up purchase                           |
| Resets     | Every calendar month        | **Never** — they carry over indefinitely             |
| Spent      | **First**                   | Only after the month's included allowance is used up |

Because the monthly bundle is always spent first, a top-up is never wasted:
purchased credits sit behind your allowance and are only touched once it runs
out, and whatever you don't use stays on your balance for future months.

### Buy a top-up

<Steps>
  <Step title="Open Billing">
    Go to **Settings → Billing**. Buying credits requires the **Admin** or
    **Owner** role.
  </Step>

  <Step title="Choose a pack">
    Under **Replayfy AI**, click **Buy more credits** and pick a pack. At 100,000
    credits per US dollar, the packs are:

    | Pack  | Credits    |
    | ----- | ---------- |
    | \$10  | 1,000,000  |
    | \$25  | 2,500,000  |
    | \$50  | 5,000,000  |
    | \$100 | 10,000,000 |
  </Step>

  <Step title="Pay in place">
    Enter your card — Link and wallet methods work too — and confirm. There's no
    redirect; credits land on your balance within a few seconds of a successful
    payment.
  </Step>
</Steps>

<Check>
  Every top-up appears as a dated receipt in the **AI credits** section of the
  Billing page, alongside your subscription invoices.
</Check>

## When credits run low

Replayfy AI is designed to **pause rather than bill you by surprise**. When a
workspace has spent both its monthly allowance and any purchased credits, AI
features stop until more credits are available — you're never charged for
overage you didn't choose.

Crucially, **only the AI features pause**. Everything else keeps running exactly
as before:

<CardGroup cols={2}>
  <Card title="Keeps working" icon="circle-check">
    Session recording and replay, product analytics, funnels and cohorts you've
    already built, crash reporting, and alerts — none of it depends on AI
    credits.
  </Card>

  <Card title="Pauses until refilled" icon="circle-pause">
    New Ask answers and investigations, AI-built funnels/cohorts, and the
    proactive Storyline and Signals reads.
  </Card>
</CardGroup>

AI comes back automatically the moment credits are available again — either when
your **included allowance resets** at the start of the next calendar month, or as
soon as you **buy a top-up**.

<Warning>
  Running out of AI credits never affects session capture. If your *recording*
  stops, that's a separate, plan-level limit (the monthly session ceiling or a
  billing issue) — see
  [Workspaces & billing](/platform/workspaces-and-billing#if-recording-stops).
</Warning>

## Where to see usage and buy more

Your live credit picture lives on the **Billing** page, and the **AI** settings
panel links straight to it so there's a single source of truth.

<AccordionGroup>
  <Accordion title="Settings → Billing" icon="credit-card">
    The **Replayfy AI** tile shows credits **used vs. included** this cycle and
    how many are **remaining** (with purchased credits called out separately when
    you have any). Below it, the **AI credits** section breaks spending down by
    product surface over the last 30 days and lists a receipt for every top-up.
    **Buy more credits** lives here too.
  </Accordion>

  <Accordion title="Settings → AI" icon="sparkles">
    The AI panel confirms Replayfy AI is active and managed for your workspace,
    and includes a **View AI usage in billing** link that jumps to the same
    credits breakdown — usage isn't duplicated, so the numbers can never disagree.
  </Accordion>
</AccordionGroup>

<Note>
  Viewing your plan and usage is open to everyone in the workspace, but
  **buying credits and changing your plan require Admin or Owner**. Members and
  Viewers see the Billing page read-only.
</Note>

## Common questions

<AccordionGroup>
  <Accordion title="Do unused monthly credits roll over?">
    No. The **included** monthly allowance resets to full at the start of each
    calendar month (UTC) and doesn't carry over. **Purchased** top-up credits are
    the opposite — they never expire and stay on your balance until spent.
  </Accordion>

  <Accordion title="Will I ever be charged for going over?">
    No. When credits run out, AI features pause instead of billing you for
    overage. You only ever pay more if you deliberately buy a top-up or move to a
    higher plan.
  </Accordion>

  <Accordion title="Does asking a question cost the same every time?">
    Not exactly — each request is metered by the actual work it did, so a quick
    answer costs less than a deep investigation. The per-surface breakdown on the
    Billing page shows where your credits actually went.
  </Accordion>

  <Accordion title="Can I turn off the proactive insights to save credits?">
    Yes. Toggling Replayfy AI **off** for the workspace stops the scheduled
    Storyline and Signals generation, and the Overview falls back to
    threshold-based cards. The switch is instant and reversible.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Replayfy AI" icon="sparkles" href="/platform/replayfy-ai">
    What credits buy — the assistant, investigations, storylines, and signals.
  </Card>

  <Card title="Workspaces & billing" icon="credit-card" href="/platform/workspaces-and-billing">
    Plan allowances, the session ceiling, invoices, and top-ups in context.
  </Card>
</CardGroup>
