About credits in Agent UI
Credits are the units Agent UI uses when your apps interact with AI models or connect to external tools. Every time you send a message in a chat app, run a workflow, or trigger an integration, credits are consumed based on the amount of work performed behind the scenes.
1 credit = $0.25 USD
Credit usage adjusts dynamically 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. Credits are only used when an AI model or external integration is called.
Per-platform credit tracking
Agent UI tracks credit usage separately for each AI provider your apps connect to:
- Agent UI (internal platform operations)
- OpenAI
- Anthropic
- Google Gemini
- Perplexity
- Other LLM providers
This gives you granular visibility into where your credits are going and which providers your apps rely on most.
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 |
Auto-charge
Agent UI supports automatic credit reloading so your apps never stop running unexpectedly.
When auto-charge is enabled, your account is automatically topped up when your credit balance falls below a USD Dollar 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 so you can take action before your apps are interrupted.
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 or run workflows.
- 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.
Do workflow executions that fail still use credits?
If an AI model was called before the failure occurred, the tokens processed up to that point will consume credits. Steps that were not reached do not consume credits.
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.