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

# AI Router credits and spending

> Credits are the AI Router's budgeting system. Top up your balance, configure auto top-up, set per-key spending limits, and view transaction history.

The Credits page lets you manage your AI Router balance, add payment methods, configure automatic top-ups, and track all credit transactions.

<Frame caption="The Credits page in AI Router, showing your balance, payment method, auto top-up settings, and transaction history.">
  <img src="https://mintcdn.com/orqai/9GDim2J4lp3mMuDR/images/router-credits.png?fit=max&auto=format&n=9GDim2J4lp3mMuDR&q=85&s=33f19e0c5401909393f5c19bb5628c0a" alt="Credits page" width="2802" height="1914" data-path="images/router-credits.png" />
</Frame>

<Tip>
  Using credits, you can access Orq.ai [Supported Models](/docs/proxy/supported-models) without needing a personal API key.
</Tip>

## Available Balance

Your current credit balance is displayed at the top of the page. Credits are consumed as you make requests through the AI Router. Each model call deducts from your balance based on token usage and model pricing.

<Info>
  When you exceed the traces included in your package, tracing costs are also deducted from your credits. Credit purchases have a minimum amount of \$5. See [AI Router pricing](https://router.orq.ai/pricing) for model and tracing cost details.
</Info>

<Warning>
  When your balance reaches zero, all AI Router requests are blocked until credits are added.
</Warning>

## Add Credits

Click **Add Credits** to purchase additional credits and top up your balance.

<Steps>
  <Step title="Click Add Credits">
    Click the **Add Credits** button in the Available Balance panel.
  </Step>

  <Step title="Enter an amount">
    Enter the dollar amount you want to add to your balance.
  </Step>

  <Step title="Add a Tax ID (optional)">
    Expand the **Edit Tax ID** section to add your tax identifier. Tax IDs are supported globally. Select your country and the applicable tax ID type, then enter your number. This is optional but recommended for businesses that need it reflected on invoices.
  </Step>

  <Step title="Select a payment method">
    Choose an existing payment method or add a new card.
  </Step>

  <Step title="Enter your name and billing address">
    Provide your name and billing address. This is required for payment processing with Stripe.
  </Step>

  <Step title="Confirm purchase">
    Confirm the transaction. Credits are added to your balance immediately.
  </Step>
</Steps>

## Payment Method

Add a credit card to enable credit purchases and auto top-up. Click **Add new** in the Payment Method panel to register a card.

<Info>
  At least one payment method is required to enable auto top-up.
</Info>

## Auto Top-up

Auto top-up ensures your balance never runs out by automatically purchasing credits when it drops below a threshold.

To configure auto top-up:

1. Enable the **Auto Top-up** toggle.
2. Set the **If balance drops below** threshold (e.g. \$50). A top-up is triggered when your balance falls below this amount.
3. Set the **Add credits amount** (e.g. \$200). This is the amount automatically added each time.
4. Click **Save changes**.

<Tip>
  Set your threshold high enough to avoid service interruptions during peak usage. A common setup is to trigger at \$50 and add \$200.
</Tip>

## Transaction History

The Transaction History table shows a log of credit purchases only. Usage deductions from individual API calls are not listed here. Refer to the [AI Router dashboard](/docs/router/dashboard) for usage details.

| Column | Description                                                                       |
| ------ | --------------------------------------------------------------------------------- |
| Date   | The date of the transaction                                                       |
| Time   | The time of the transaction                                                       |
| Type   | The transaction type: **Purchase** (manual top-up) or **Auto Top-up** (automatic) |
| Amount | The credit amount added to your balance                                           |

### Filtering Transactions

Use the **Filter** button to narrow down the transaction history by type:

* **Purchase**: manual credit top-ups
* **Auto Top-up**: automatic top-ups triggered by the auto top-up threshold

## Invoices

Each credit purchase generates an invoice. To open an invoice, click the <Icon icon="ellipsis" /> icon on the corresponding row in the Transaction History table and select **Download Invoice**.