Auto Top-Up
Automatically refill your credit balance when it runs low so your API calls never get interrupted.
Never run out of credits mid-workflow. Auto Top-Up monitors your credit balance and purchases a credit pack on your behalf the moment your balance drops below a configurable threshold.
How it works
Set a threshold
Choose the percentage of your remaining credits at which the automatic purchase should trigger. When your balance falls below this level, Auto Top-Up activates.
Pick a credit pack
Select the one-time credit pack to purchase automatically. The pack is charged to the payment method on file in your account.
Credits are added instantly
Once the purchase completes, the credits are added to your balance immediately. No downtime, no failed requests.
Enabling Auto Top-Up
- Go to Settings → Subscription in your dashboard.
- Open the Auto Top-Up section.
- Toggle Enable and choose a credit pack and a threshold percentage.
- Click Save to activate.
Auto Top-Up is only available on paid plans. Users on the Free plan cannot enable automatic purchases.
Configuration options
| Option | Description |
|---|---|
| Credit pack | The one-time credit bundle purchased automatically when the threshold is reached. |
| Threshold (%) | The percentage of your remaining credits that triggers the top-up. Accepts values between 10% and 30%. |
Billing
Automatic purchases are charged to the payment method associated with your account. You will receive an invoice by email for each automatic purchase, just like a manual credit purchase.
Make sure your payment method is up to date. If a charge fails, Auto Top-Up is automatically disabled on your account to prevent repeated failed attempts. You will need to re-enable it manually once your payment method is updated.
Built-in protections
Auto Top-Up includes two safeguards to prevent unexpected charges:
| Protection | How it works |
|---|---|
| Threshold-only trigger | A purchase only fires when your remaining balance drops below the configured percentage. It never runs on a fixed schedule or at a specific time. |
| 72-hour cooldown | After a top-up completes, the system waits at least 72 hours before it can trigger again, even if your balance drops below the threshold a second time during that window. |
| Auto-disable on failure | If the Stripe charge fails, Auto Top-Up is automatically disabled to protect your account from repeated failed payment attempts. |
Frequently asked questions
Will I be charged immediately when I enable Auto Top-Up?
No. Enabling Auto Top-Up does not trigger a purchase. The charge only fires when your balance actually drops below the configured threshold.
Can I be charged multiple times in a short period?
No. A built-in 72-hour cooldown prevents more than one automatic purchase from firing within any 72-hour window, regardless of how your balance fluctuates.
Can I disable Auto Top-Up at any time?
Yes. Toggle the Enable switch off in Settings → Subscription → Auto Top-Up and save. No further automatic purchases will occur.
What happens if my payment fails?
Auto Top-Up is automatically disabled on your account. You will need to update your payment method and re-enable the feature manually from your subscription settings.
Is Auto Top-Up available on the Free plan?
No. You need an active paid subscription to enable automatic credit top-ups.