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

# Top up

> Manual top-up flow, crediting times and invoices

OpenPAI uses a **prepaid** model: once your account quota is exhausted you can't call paid models, so top up before your balance runs low.

## How to top up

<Note>Top-ups are currently **manual only** and must be arranged through your dedicated agent — self-service payment is not yet available in the console.</Note>

All top-ups are handled manually through an **agent**:

<Steps>
  <Step title="Contact your agent">
    Reach out to your dedicated agent. If you don't have one yet, contact support via the website or official community to get connected.
  </Step>

  <Step title="Provide the amount and pay">
    Tell the agent how much you want to top up and complete payment following their instructions.
  </Step>

  <Step title="Agent adds credit">
    After confirming your payment, the agent manually credits the corresponding amount to your account.
  </Step>

  <Step title="Credit arrives">
    Once credited, check the new balance on the **account home**.
  </Step>
</Steps>

## Use a redemption code

If you have a redemption code from your agent or a promotion:

1. Go to **Top up** → **Redemption code** tab.
2. Enter the 16-32 character code and click **Redeem**.
3. On success, the credit arrives immediately and can be checked in the **account log**.

## Request an invoice

To get an invoice, contact your agent for assistance and provide the invoice title, tax number and other required details.

## Check your quota

* **Account home**: real-time balance and this month's spend.
* **Account log**: details of every top-up, charge and refund.
* **Token list**: per-token spend statistics.
* **API**: [check account balance](/en/api-reference/account/balance).

## Low balance

When your balance is nearly exhausted, the system warns you via:

* **Console banner**: shown at the top after signing in.
* **Email alerts**: enable under **Profile settings → Notifications**.
* **API response header**: every response includes `X-OpenPAI-Remaining-Quota`.

When the balance hits 0, all paid model calls return:

```json theme={null}
{
  "error": {
    "code": "insufficient_quota",
    "message": "Account quota exhausted, please top up and retry.",
    "type": "billing_error"
  }
}
```

## FAQ

<AccordionGroup>
  <Accordion title="Payment succeeded but credit didn't arrive">
    Contact the agent who topped up your account to verify, and keep your payment receipt / order details for reference.
  </Accordion>

  <Accordion title="Can I get a refund?">
    Unspent credit can be refunded within 30 days by contacting your agent, minus any processing fees. Credit that has been spent or is older than 30 days cannot be refunded.
  </Accordion>

  <Accordion title="Are there minimum / maximum top-up limits?">
    Confirm amounts and limits with your agent. For large top-ups or enterprise payments, contact the business channel.
  </Accordion>
</AccordionGroup>