Overview
Guide for managing credits on OpenRouter, including purchasing credits and setting up auto top-up.
Prerequisites
- OpenRouter account
- Registered payment method (credit card)
Sign In
- Navigate to https://openrouter.ai/settings/credits
- If not signed in, you'll be redirected to sign-in page
- Available sign-in methods:
- button "Sign in with GitHub"
- button "Sign in with Google"
- button "Sign in with MetaMask"
- textbox "Email address" + button "Continue"
Check Balance
After sign in, the Credits page shows:
- "Remaining credits: X.XXX" - current balance
- "Recent Transactions" table - purchase history
Purchase Credits
- Click button "Add Credits"
- Purchase dialog opens with:
- Payment method selector (e.g., "VISA (XXXX) MM/YYYY")
- spinbutton for Amount (default: $10)
- "Service fees" display
- "Total due" display
- Adjust amount if needed
- Click button "Purchase"
- Wait for confirmation - balance updates automatically
Enable Auto Top-Up
Automatically purchase credits when balance drops below threshold.
- Find "Auto Top-Up" section on Credits page
- Click button "Enable"
- Dialog opens with switch "Enable auto top up"
- Click the switch to enable
- Default settings appear:
- "When credits are below: $2"
- "Purchase this amount: $25"
- Payment method selector
- Adjust threshold and amount if needed
- Click button "Close" to save
Manage Auto Top-Up
After enabling, the section shows:
- "Auto top-up is enabled and will add X credits automatically when your balance drops below Y."
- button "Manage" - click to modify settings
Common Issues
| Issue | Cause | Solution |
|---|---|---|
| 402 Error in API calls | Balance insufficient | Add credits |
| Negative balance | API consumed more than available | Add credits to restore positive balance |