Skip to main content
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

Top-ups are currently manual only and must be arranged through your dedicated agent — self-service payment is not yet available in the console.
All top-ups are handled manually through an agent:
1

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.
2

Provide the amount and pay

Tell the agent how much you want to top up and complete payment following their instructions.
3

Agent adds credit

After confirming your payment, the agent manually credits the corresponding amount to your account.
4

Credit arrives

Once credited, check the new balance on the account home.

​
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.

​
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: 
{
  "error": {
    "code": "insufficient_quota",
    "message": "Account quota exhausted, please top up and retry.",
    "type": "billing_error"
  }
}

​
FAQ

Contact the agent who topped up your account to verify, and keep your payment receipt / order details for reference.
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.
Confirm amounts and limits with your agent. For large top-ups or enterprise payments, contact the business channel.