Billing & Credits
Understand how Lux usage is billed and manage your credits.
Credit System
Lux uses a credit system for usage-based billing. Credits are consumed when you:
- Run AI models (Claude, GPT)
- Send emails
- Send SMS messages
- Make voice calls
- Use voice synthesis
Credit Consumption
AI Models
| Model | Credits per 1K tokens |
|---|---|
| Claude Haiku | 1 |
| Claude Sonnet | 5 |
| Claude Opus | 15 |
| GPT-4o | 5 |
| GPT-4o-mini | 1 |
Communication
| Service | Credits |
|---|---|
| Email (Resend) | 1 per email |
| SMS | 2 per message |
| Voice call | 5 per minute |
| Voice synthesis | 1 per 1K characters |
Checking Balance
Via Lux Studio
Navigate to Settings → Billing to see:
- Current credit balance
- Usage history
- Spending breakdown
Via CLI
lux creditsUsage Monitoring
Per-Flow Costs
Each flow execution logs credit usage:
{
"flowId": "flow_123",
"executionId": "exec_456",
"credits": {
"ai": 12,
"email": 1,
"total": 13
}
}Usage Reports
View usage in Settings:
- Daily/weekly/monthly breakdown
- By flow
- By integration type
Managing Costs
Cost Optimization Tips
-
Use appropriate models
- Use Haiku for simple tasks
- Reserve Opus for complex reasoning
-
Optimize prompts
- Shorter prompts = fewer tokens
- Cache repeated operations
-
Batch operations
- Combine multiple small operations
- Use bulk APIs where available
-
Monitor usage
- Set up alerts for high usage
- Review flow efficiency regularly
Setting Limits
Configure spending limits:
- Go to Settings → Billing
- Set monthly credit limit
- Enable notifications at thresholds
Purchasing Credits
Via Lux Studio
- Navigate to Settings → Billing
- Click Add Credits
- Select amount
- Complete payment
Plans
| Plan | Credits/month | Best For |
|---|---|---|
| Free | 1,000 | Testing |
| Starter | 10,000 | Small projects |
| Pro | 100,000 | Production apps |
| Enterprise | Custom | Large scale |
Billing History
View past invoices and credit purchases:
- Go to Settings → Billing
- Click History
- Download invoices as needed
Organization Billing
For organizations:
- Single billing account for all members
- Admin controls spending limits
- Usage attributed to flows/users
- Consolidated invoicing
Free Tier
New accounts include:
- 1,000 free credits
- Basic features
- Community support
No credit card required to start.
FAQ
What happens when credits run out?
- Flows pause execution
- You receive notification
- Add credits to resume
Do credits expire?
- Purchased credits don't expire
- Monthly allotments reset each billing cycle
Can I get a refund?
- Unused purchased credits can be refunded within 30 days
- Contact support for assistance
How do I estimate costs?
Use the cost calculator in Settings, or:
Estimated monthly cost =
(AI calls × tokens × model rate) +
(Emails × 1) +
(SMS × 2) +
(Voice minutes × 5)See Also: