Credits
The credit is Sosyabot's AI usage unit. It's a simple counter on the workspace, debited per metered call, and reset monthly.
What costs credits
| Action | Cost |
|---|---|
Inline text generation (/ai/inline) | 1 |
Image generation (/ai/images) | 5 |
Video generation (/ai/videos, charged at submit) | 20 |
| Stored prompts, templates, categories, suggestions, agents | not metered per call |
Plan caps
Default values seeded by backend/src/scripts/seed-default-plans.ts:
| Plan | ai_credits per month |
|---|---|
| Free | 50 |
| Pro | 1 000 |
| Business | 10 000 |
| Enterprise | 50 000 |
Admins can override these limits per plan from Plans Admin.
Storage
Credits are tracked in the UsageCounter collection with a key of ai_credits and a period of YYYY-MM (calendar month). The counter resets when the period flips on the 1st of the month.
Reading current usage
There is no dedicated read-credits endpoint in the user surface today. The dashboard surfaces consumption via the Analytics widgets, and admins can query UsageCounter directly.
What happens at the cap
When a metered call would exceed the plan's monthly cap, Sosyabot returns a 402-style error. Failed video jobs still consume their 20 credits because the debit happens at submit time.