# Usage ledger and invoices

> How to read workspace usage, project cost, member usage, top-ups, and invoices.

Canonical: https://docs.onira.studio/billing/usage-ledger-and-invoices
Section: billing

The billing overview is the practical ledger for a workspace. It summarizes plan state, remaining credits, frozen credits, usage, top-up balance, and invoice access.

## Billing overview

Use the overview to check:

- Active plan.
- Available credits.
- Frozen credits.
- Credits used in the current cycle.
- Renewal date.
- Top-up credit balance.
- Usage over time.
- Usage by project.
- Usage by member.

The overview is workspace-specific. If you belong to more than one workspace, confirm the workspace in the sidebar before comparing usage or invoices.

## Usage by project

Project usage helps identify which productions consumed credits. Use it when you need to reconcile a client job, agency workspace, or internal production budget.

Usage can include work from several stages:

- Planning and blueprint work.
- Narration.
- Music.
- Image generation.
- Video clip generation.
- Assembly.
- Render attempts.
- Retries that perform new provider work.

Completed assets are reused where the system can resume from recoverable state. A retry should not automatically repeat every upstream cost.

## Usage by member

Member usage helps workspace owners understand who initiated work. It is useful for:

- Shared agency workspaces.
- Client-facing teams.
- Internal chargeback.
- Investigating unexpected credit usage.

Member usage should be read as operational attribution, not as a complete creative audit. The project history and Studio messages provide more context for what happened inside a project.

## Frozen credits

Frozen credits represent credits reserved for in-progress work. They reduce the available balance while a production or render is active.

If a run fails, resumes, or settles, the frozen amount can change as the backend records what work actually happened.

## Invoices

The billing area exposes invoice access for workspace billing. Use invoices for:

- Accounting records.
- Refund requests.
- Subscription verification.
- Top-up purchase reconciliation.

For support, include the invoice number, workspace name, and the relevant project link when the invoice relates to production work.

## Top-up ledger behavior

Top-up purchases are tracked separately from plan credits. Onira spends plan credits first, then top-up lots by expiry order.

This means a workspace can have:

- Monthly plan credits that reset at renewal.
- Top-up credits that remain after renewal.
- Multiple top-up lots with different purchase dates.

Do not assume the visible total all expires at the same time.

## Product and publication boundary

- Onira produces a reviewable MP4; it does not upload or schedule social posts.
- Creators remain responsible for facts, sources, rights, disclosure, policy review, and final publication.
- Research is research-assisted; creator verification is required before publication.
- Onira does not guarantee factual accuracy, legal clearance, monetization, reach, or production success.
- The current Timeline and Studio surfaces support defined review and regeneration workflows, not arbitrary nonlinear editing.