About credits in Agent UI
Credits are the units Agent UI uses when you interact with AI to create or modify apps and automations. Every message you send to the AI assistant consumes credits based on the amount of work performed behind the scenes, including the AI model used and the number of tokens processed.
1 credit = $0.25 USD
Credits are calculated depending on the AI model used, the complexity of the request, and the number of tokens processed.
Types of credits
Agent UI uses 2 types of credits:
Subscription credits
These credits come with your paid plan and reset automatically on your billing renewal date each month. They are your primary credit balance for day-to-day usage.
Purchased credits
These are one-time credit purchases that supplement your subscription credits. Purchased credits expire 1 year after the purchase date if unused.
When your account consumes credits, subscription credits are used first. Purchased credits are drawn from only after your subscription balance is depleted.
How credits are used
There is no fixed credit amount per action. Different operations use credits in different ways, depending on the AI model invoked and how much processing is required.
Understanding credit usage
Credits are calculated based on the actual tokens processed — both input and output — by the underlying AI model. A short prompt that generates a brief response uses fewer credits than a complex prompt that processes large documents or generates lengthy output.
Manual actions like editing workflow configurations, managing team settings, or organizing files do not consume credits.
Example of Credit Usage
Type of request | What it usually does | Typical credits used |
|---|---|---|
Simple visual or text change | A lightweight update that touches a single element or short piece of text. | ~ 0.5 credits |
Improving a small feature | Inspects a few files and adjusts logic, so usage is higher than a simple style tweak. | ~ 1 credit |
Adding a complex feature | Larger upgrade that includes entities, flows, and logic, requiring deeper planning and more steps. | ~ 5 credits |
These examples are illustrative only. Actual usage depends on the AI model and tokens processe
Auto-charge
Agent UI supports automatic credit reloading.
When auto-charge is enabled, your account is automatically topped up when the USD value of your remaining credits falls below a configurable threshold.
- Default threshold: 50 dollars — when your balance drops below this amount, a reload is triggered.
- Default reload amount: 200 dollars — the number of credits purchased on each auto-charge.
Both the threshold and reload amount can be customized in your workspace billing settings.
Important notes about auto-charge:
- Auto-charge uses your card on file through Stripe.
- If a payment fails (card declined, 3D Secure authentication required, etc.), auto-charge is automatically disabled to prevent repeated failed attempts. You will need to update your payment method and re-enable it.
- The system includes safeguards to prevent duplicate charges during concurrent usage.
Low credit alerts
When your credit balance falls below $0.50 (2 credits), Agent UI automatically sends an email notification to your account.
Checking your credit balance
Your credit balance is updated in real time. You can view your current balance and usage breakdown at any time from your workspace settings.
To check your balance:
1. Click your profile icon in the sidebar.
2. Go to Settings.
3. Navigate to Billing to see your used and remaining credits, broken down by platform.
Credit resets
Your credits refresh based on your credit type:
- Subscription credits: Reset on your billing renewal date — the same day of the month you subscribed. For example, if you subscribed on March 10, your credits reset on the 10th of every month.
- Purchased credits: Do not reset. They remain available until used or until they expire 1 year after purchase.
Credits do not roll over. Unused subscription credits expire at the end of your billing cycle. If you reach your credit limit, actions that require credits will pause until your next reset or until you purchase additional credits.
Using credits with teams
Agent UI uses a company-based workspace model. Each workspace (company) has its own credit pool that is shared across all members of that workspace.
When working together in a workspace:
- AI usage: All team members draw from the same workspace credit balance when their apps call AI models.
- Per-user roles: Admins can manage billing and credit settings. Creators consume credits but cannot modify billing configuration.
Maximizing your credits
Get more out of your Agent UI credits with these practical tips:
Choose the right AI model
Different AI providers have different cost profiles. If a task doesn't require the most advanced model, using a lighter model can significantly reduce credit consumption.
Keep prompts focused
Short, targeted prompts that clearly describe what you need will use fewer tokens and therefore fewer credits than vague or overly broad instructions.
Use knowledge bases effectively
Structure your knowledge base well so vector search returns relevant results quickly, reducing the need for follow-up queries that consume additional credits.
FAQs
Why does my credit usage vary between similar requests?
Credit usage depends on the total tokens processed, which includes both the input (your prompt plus any context the AI needs to read) and the output (the AI's response). Even similar-looking requests can differ in token count based on conversation history, knowledge base context, or response length..
Can I purchase credits without changing my plan?
Yes. You can make one-time credit purchases at any time. These purchased credits supplement your subscription balance and expire 1 year after purchase.
How does auto-charge work with 3D Secure?
Auto-charge uses off-session Stripe payments. If your card requires 3D Secure authentication, the auto-charge will fail and be disabled. You'll need to complete a manual payment with authentication, then re-enable auto-charge.
Are credits shared across workspaces?
No. Each workspace has its own independent credit balance. If you belong to multiple workspaces, each one tracks and consumes credits separately.
Can I still use my apps if I run out of credits?
Yes. You can continue using app features that do not invoke AI. Only AI-powered actions pause until your credits reset or you purchase additional credits.
How can I see what used my credits?
You can view your credit usage history from Settings → Billing, where usage is broken down by date, AI provider, and operation.