For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesDeveloper Console
API DocumentationOpen Source ModelAPI Changelog
API DocumentationOpen Source ModelAPI Changelog
  • Getting Started
    • Introduction
    • Quick Start
  • Implementation Guides
    • Authentication
    • Supported Models
    • Input Formats
    • Prompting Guide
    • Async Jobs
    • Rate Limits
    • Error Handling
    • Debugging Requests
  • Billing
    • Pricing
    • Auto Top-Up
  • API Reference
LogoLogo
Contact SalesDeveloper Console
On this page
  • Auto top-up process
  • Setting up auto top-up
  • Threshold
  • Top-up amount
  • Frequently asked questions
Billing

Auto Top-Up

Automatically purchase credits when your balance runs low
Was this page helpful?
Edit this page
Previous

Generate video from text

Next
Built with

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

  1. When an API generation request is made, the system checks your available balance against your configured threshold.
  2. If your balance is below the threshold, a credit purchase for the configured top-up amount is initiated while generation proceeds.
  3. If your balance is above the threshold, no purchase occurs and generation proceeds normally.
  4. 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 Developer Console.

SettingDescription
ThresholdWhen your credit balance drops below this amount, a top-up is triggered.
Range: $10 - $10,000
Top-up amountThe amount charged to your card each time auto top-up triggers.
Range: $5 - $2,500

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 Developer Console.

Threshold

Set the threshold high enough to cover a burst of usage before the next top-up processes:

Usage levelRecommended threshold
Low (a few requests at a time)$10
Medium (regular API usage)$15–$20
High (heavy or batch workloads)$40+

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 Developer 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 Developer Console if needed, then re-enable auto top-up with your desired threshold and top-up amount.