> ## 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 Gateway credits and spending

> Credits are the AI Gateway's budgeting system. Top up the balance, configure auto top-up, and view transaction history.

The Credits page is where the **AI Gateway** balance, payment methods, automatic top-ups, and credit transactions are managed.

<Frame caption="The Credits page in AI Gateway, showing the balance, payment method, auto top-up settings, and transaction history.">
  <img src="https://mintcdn.com/orqai/lqVyDy-llJ4XuTsl/images/credits-gateway.png?fit=max&auto=format&n=lqVyDy-llJ4XuTsl&q=85&s=71d85af12044372b4976699db3a8acb9" alt="Credits page showing available credits balance, auto top-up settings, payment method, and transaction history." width="2140" height="1268" data-path="images/credits-gateway.png" />
</Frame>

<Tip>
  Credits provide access to [Supported Models](/docs/ai-gateway/supported-models) without a personal API key.
</Tip>

## Available credits

The current credit balance is displayed at the top of the page and is shared across all projects in the organization. Credits are consumed as requests are made through the **AI Gateway**. Each model call deducts from the balance based on token usage and model pricing.

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

<Warning>
  When the balance reaches zero, all **AI Gateway** requests are blocked until credits are added.
</Warning>

## Add Credits

Click <kbd>Add Credits</kbd> to purchase additional credits and top up the balance.

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

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

  <Step title="Add a Tax ID (optional)">
    Expand the **Edit Tax ID** section to add a tax identifier. Tax IDs are supported globally. Select the country and applicable tax ID type, then enter the number. 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 name and billing address">
    Provide a name and billing address. Required for payment processing with Stripe.
  </Step>

  <Step title="Confirm purchase">
    Confirm the transaction. Credits are added to the 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 the 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 **Top-up threshold** (e.g. \$50). A top-up is triggered when the balance falls below this amount.
3. Set the **Amount to add** (e.g. \$200). This is the amount automatically added each time.
4. Click **Save changes**.

<Tip>
  Set the 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 Gateway dashboard](/docs/ai-gateway/traces) 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 the 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 <kbd><Icon icon="ellipsis" /></kbd> icon on the corresponding row in the Transaction History table and select **Download Invoice**.