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

# Runs and billing

> How runs are counted, what the free plan covers, and how to subscribe or top up.

Your organization shares one pool of runs. A run is the unit of work you pay for.

Open **Organization settings → Usage & billing** for balance, plans, and top-ups. See [Pricing](https://oqoqo.ai/pricing) for current plan details.

<img className="block dark:hidden" src="https://mintcdn.com/oqoqo/0N1ap2mLLIECv0P4/images/screenshots/billing-light.png?fit=max&auto=format&n=0N1ap2mLLIECv0P4&q=85&s=a4fd4d552ba2ce0e332aaa47610da36e" alt="Usage and billing page with plan, top-up, and history areas." width="2270" height="1070" data-path="images/screenshots/billing-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/oqoqo/0N1ap2mLLIECv0P4/images/screenshots/billing-dark.png?fit=max&auto=format&n=0N1ap2mLLIECv0P4&q=85&s=23dc8dcac56c2f6d6df408f063624c51" alt="Usage and billing page with plan, top-up, and history areas." width="2270" height="1070" data-path="images/screenshots/billing-dark.png" />

## What a run is

One run is one agent attempt on a task under a treatment.

* You spend one run every time an agent tries a task under a treatment
* Errored or cancelled runs do not count against your organization's pool
* Failed rubric verdicts on a completed run still use a run. The run finished. The judge marked it fail.

```text theme={null}
tasks × treatments × agents × trials
```

Each combination is one billable run.

## What a run covers

Runs cover Oqoqo platform fees for durable experiment workflows and cloud infrastructure. Large experiments run in the cloud on workflows Oqoqo manages.

Model inference is separate. Use your own API keys or subscriptions.

Oqoqo may limit use to keep capacity fair.

## Free plan, subscriptions, and top-ups

Organizations start on the **free plan**, which resets runs each month. This is not a one-time trial.

| Kind            | Behavior                                                                                           |
| --------------- | -------------------------------------------------------------------------------------------------- |
| **Plan runs**   | Reset each billing period. Unused plan runs do not roll over. Plan runs expire when the plan ends. |
| **Top-up runs** | Bought anytime. Top-up runs never expire. Larger top-ups cost less per run.                        |

To get more runs:

1. Open **Organization settings → Usage & billing**, or start from [Pricing](https://oqoqo.ai/pricing)
2. **Subscribe** for more runs each month at a lower price per run
3. Or **Top up** anytime for runs that never expire
4. Contact us for higher volume

Every plan includes the full product: web app, CLI, MCP, unlimited members, unlimited projects, and unlimited experiments.

Checkout and receipts are handled by Stripe.

## Where to look

| Surface                                     | What you see                |
| ------------------------------------------- | --------------------------- |
| Organization settings → **Usage & billing** | Balance, plans, and top-ups |
| Launch screens                              | Run total before you start  |
| CLI `oqoqo quota inspect`                   | Balance and billing link    |
| MCP quota tools                             | Balance and billing link    |

Money actions stay in the web app. CLI and MCP return the authenticated billing URL when you need to buy more.

## Related pages

<CardGroup cols={2}>
  <Card title="Reading results" icon="chart-simple" href="/evaluation/runs-and-trials">
    How runs and trials appear in results.
  </Card>

  <Card title="Launch options" icon="play" href="/experiments/launch-options">
    How trials multiply run cost.
  </Card>

  <Card title="Model providers" icon="key" href="/setup/model-providers">
    Model inference stays on your providers.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/reference/faq">
    Common billing questions.
  </Card>
</CardGroup>
