Skip to content

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

ActionCost
Inline text generation (/ai/inline)1
Image generation (/ai/images)5
Video generation (/ai/videos, charged at submit)20
Stored prompts, templates, categories, suggestions, agentsnot metered per call

Plan caps

Default values seeded by backend/src/scripts/seed-default-plans.ts:

Planai_credits per month
Free50
Pro1 000
Business10 000
Enterprise50 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.