AI credits

Loomta’s AI features run on a credit system. Credits are allocated per account (the owner of the workspace) and shared across all workspaces under that account. Usage resets each calendar month.

Credit pools

Credits are split into two independent pools so caption and image budgets don’t compete:

Pool	What draws from it	Monthly allowance
Caption	POST /public/v1/slides/caption	By plan (see Limits)
Image	AI image generation (internal)	By plan

Exhausting one pool does not affect the other.

What spends credits

Endpoint	CLI	Pool
POST /public/v1/slides/caption	loomta slides:caption	Caption — 1 credit per call
POST /public/v1/slides/composite	loomta slides:composite	Free — no credits

Everything else — listing platforms, uploading media, creating and scheduling posts — does not spend credits. Those are governed by plan limits instead.

Running out

When a pool is exhausted the AI endpoint returns HTTP 402 — branch on the code, not the message:

{ "code": "ai_credit_limit_reached", "message": "Your plan includes 50 AI credits per month. Upgrade your plan for more." }

Note

You don’t need to check a balance before calling — the API returns a clear error when credits are exhausted. To raise your monthly allocation, upgrade the account’s plan in the dashboard.

Tips

• Generate once, reuse. slides:caption output is plain JSON — store it and feed selected captions into slides:composite without regenerating. Composite is free, so you can re-composite as many times as you like.
• Shared across workspaces. All workspaces owned by the same account draw from the same monthly pool. If you have multiple workspaces, their combined usage counts against one allowance.