Auto Top-Up
Auto Top-Up
Configure auto top-up to keep your credit balance topped up. When your balance falls below a configured threshold, a credit purchase is triggered automatically.
Auto top-up process
To configure auto top-up, you need the owner role and an existing payment method on file (you must have purchased credits at least once).
- When an API generation request is made, the system checks your available balance against your configured threshold.
- If your balance is below the threshold, a credit purchase for the configured top-up amount is initiated while generation proceeds.
- If your balance is above the threshold, no purchase occurs and generation proceeds normally.
- After 3 consecutive payment failures, auto top-up is automatically disabled and all organization owners are notified.
Important: If your balance is already below the threshold when you enable auto top-up, your card will be charged immediately to bring your balance above the threshold and verify your payment method.
Setting up auto top-up
You can enable and configure auto top-up from the API Console.
Your existing credit card on file is used for all automatic purchases.
By enabling auto top-up, you agree that your card on file will be automatically charged the configured top-up amount on a recurring basis whenever your credit balance falls below the threshold you set. To cancel, disable auto top-up from the API Console.
Threshold
Set the threshold high enough to cover a burst of usage before the next top-up processes:
You can always adjust the threshold as you learn more about your usage patterns.
Top-up amount
Check your daily spend on the Usage page and set your top-up amount to cover 2–3 days of typical usage.
Frequently asked questions
Why was my payment declined?
This can happen if your card has expired, has insufficient funds, or was declined by your bank. Contact support if you need help resolving the issue.
How do I disable auto top-up?
Go to the billing section of the API Console and click Disable. You and all other organization owners will receive an email confirmation.
How do I re-enable after payment failures?
Update your payment method in the API Console if needed, then re-enable auto top-up with your desired threshold and top-up amount.
