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

# Usage and Limits

> What counts toward your credit allowance, how to track it, and how resets work.

WriterzRoom usage is generation-based, with credits as the underlying accounting unit.

Credits are consumed when you run a generation, section regeneration, Premium Polish pass, or API-submitted generation. Credit cost is fixed per pipeline tier and, for Feature Screenplay, scales by requested page count.

## Usage Overview

<div style={{ display: 'grid', gridTemplateColumns: 'repeat(4, 1fr)', gap: '12px', margin: '1.5rem 0' }}>
  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '14px', padding: '16px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800 }}>Credits</div>
    <div style={{ fontSize: '13px', color: 'var(--colors-content-secondary)' }}>Generation activity consumes plan credits.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '14px', padding: '16px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800 }}>Tiers</div>
    <div style={{ fontSize: '13px', color: 'var(--colors-content-secondary)' }}>Quick, Standard, and Premium use different credit rates.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '14px', padding: '16px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800 }}>Resets</div>
    <div style={{ fontSize: '13px', color: 'var(--colors-content-secondary)' }}>Subscription credits reset on your billing anniversary.</div>
  </div>

  <div style={{ border: '1px solid rgba(128,128,128,0.20)', borderRadius: '14px', padding: '16px', background: 'rgba(255,255,255,0.04)' }}>
    <div style={{ fontWeight: 800 }}>Tracking</div>
    <div style={{ fontSize: '13px', color: 'var(--colors-content-secondary)' }}>Usage is visible in the Dashboard and API.</div>
  </div>
</div>

## What Consumes Credits

Every generation run consumes credits based on the pipeline tier selected at generation time.

The credit cost is fixed per tier regardless of content length, template complexity, or number of expansion attempts within a single generation. Feature Screenplay is the exception because it scales by requested page count.

| Action                    | Credit Cost                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| Quick generation          | 2 credits                                                                                |
| Standard generation       | 8 credits                                                                                |
| Premium generation        | 10 credits                                                                               |
| Premium Polish (any tier) | 5 credits                                                                                |
| Section regeneration      | Same as the pipeline tier used                                                           |
| API-submitted generation  | Same as the pipeline tier used                                                           |
| Feature Screenplay        | Scales by page count — see [Screenplay Credit Scaling](#screenplay-credit-scaling) below |

A single generation that requires expansion attempts still costs the same number of credits. You are not double-charged for expansion rounds within one generation request.

## Screenplay Credit Scaling

Feature Screenplay generations are charged based on page count rather than a flat tier rate.

Credits are calculated in blocks of 15 pages, with the base tier cost as the per-block rate.

| Pages Requested | Tier     | Credit Cost |
| --------------- | -------- | ----------: |
| 1 to 15         | Quick    |   2 credits |
| 1 to 15         | Standard |   8 credits |
| 16 to 30        | Standard |  16 credits |
| 31 to 35        | Standard |  24 credits |
| 1 to 15         | Premium  |  10 credits |
| 16 to 30        | Premium  |  20 credits |
| 31 to 45        | Premium  |  30 credits |
| 46 to 60        | Premium  |  40 credits |
| 61 to 70        | Premium  |  50 credits |

For full features, use the Act Focus parameter to generate each act as a separate generation and assemble the draft in the Content editor. This is the recommended workflow for professional screenplay development.

## What Does Not Consume Credits

These actions do not consume generation credits:

* Viewing saved content in the Content Library
* Editing saved drafts in the rich text editor
* Exporting content as Markdown, HTML, or PDF
* Sharing content via link
* Publishing to connected platforms
* Browsing templates and style profiles
* Configuring brand voice or vertical settings
* Viewing analytics and content intelligence scores

## Tracking Your Usage

Your current credit balance and usage breakdown are visible on the **Dashboard**.

The Dashboard shows credits remaining, credits consumed by pipeline type, number of generations in the current billing cycle, and your credit reset date.

For programmatic access, the API exposes usage data at two endpoints:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /api/credits/usage
GET /api/credits/history
```

| Endpoint                   | Description                                      |
| -------------------------- | ------------------------------------------------ |
| `GET /api/credits/usage`   | Current balance and consumption breakdown        |
| `GET /api/credits/history` | Transaction-level credit history with timestamps |

## Credit Reset Cycle

Subscription credits reset on your billing anniversary date, not the calendar month boundary.

If you subscribed on March 15, your credits reset on April 15. Unused subscription credits do not roll over to the next cycle.

Add-on pack credits operate on a separate 90-day expiry window from the date of purchase. They are consumed only after your monthly subscription credits are fully depleted.

## Notifications

WriterzRoom sends usage notifications at two thresholds:

| Threshold  | Behavior                                                                 |
| ---------- | ------------------------------------------------------------------------ |
| 90% usage  | Warning that your monthly credits are nearly exhausted                   |
| 100% usage | Generation is blocked until credits reset or an add-on pack is purchased |

## Rate Limits

API-submitted generations are rate-limited to 10 requests per minute per user. This prevents accidental bulk consumption from scripts or integrations.

The UI does not impose rate limits beyond what the API enforces.

## Evaluation Access

The Demo plan provides 7-day evaluation access with:

* 4 Quick generations
* 1 Standard generation

The included Standard generation lets you experience the full research-backed pipeline before committing. Use Demo access to test both tiers on topics you would actually generate in production.

The 7-day trial on Starter, Professional, and Enterprise plans provides access to the selected plan during the trial period. Trial terms and usage allowances are shown at checkout. If you do not cancel before the trial ends, your subscription begins and the first billing cycle starts.

Annual plan subscribers receive their full year of credits at the start of the first paid cycle.

## Usage Workflow

<Steps>
  <Step title="Choose the generation tier">
    Select Quick, Standard, or Premium based on the depth and quality requirements of the content.
  </Step>

  <Step title="Confirm credit impact">
    Review the credit cost before running a generation, especially for screenplay page-count workflows.
  </Step>

  <Step title="Track balance">
    Use the Dashboard or API usage endpoints to monitor remaining credits.
  </Step>

  <Step title="Add credits or wait for reset">
    Purchase an add-on pack or wait for the next billing anniversary when credits are depleted.
  </Step>
</Steps>

## Operational Guidance

<AccordionGroup>
  <Accordion title="Are expansion attempts charged separately?">
    No. Expansion attempts within one generation request are included in the original generation cost.
  </Accordion>

  <Accordion title="Do unused subscription credits roll over?">
    No. Subscription credits reset each billing cycle and unused credits do not roll over.
  </Accordion>

  <Accordion title="When are add-on credits used?">
    Add-on credits are consumed after monthly subscription credits are depleted. They expire 90 days after purchase.
  </Accordion>

  <Accordion title="Why does Feature Screenplay scale differently?">
    Screenplay output scales by page count, so credit cost is calculated in 15-page blocks instead of one flat tier charge.
  </Accordion>
</AccordionGroup>

<Tip>
  Use Demo credits on realistic production topics. This gives the clearest signal on whether Quick or Standard fits your workflow.
</Tip>

<CardGroup cols={2}>
  <Card title="Plans and Pricing" icon="credit-card" href="/billing/plans-and-pricing">
    Compare plans, credit allowances, and pipeline access.
  </Card>

  <Card title="Billing Management" icon="receipt" href="/billing/billing-management">
    Manage invoices, subscriptions, upgrades, downgrades, and cancellation.
  </Card>
</CardGroup>