AI credits

Loomta’s AI features run on a credit system. Credits are allocated per workspace by its plan and are consumed when you call the AI endpoints.

What spends credits

Endpoint	CLI	Spends credits
POST /public/v1/slides/caption	loomta slides:caption	✅ Generates a caption + per-slide text
POST /public/v1/slides/composite	loomta slides:composite	✅ Bakes captions onto images

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

Running out

Credits are metered against the workspace. When a workspace has none left, the AI endpoints fail rather than silently doing nothing — branch on the error code (for example insufficient_credits) rather than the prose:

{ "code": "insufficient_credits", "message": "This workspace has no AI credits remaining." }

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 workspace’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 per image. A 10-slide carousel composites 10 captions in one call; size your requests accordingly.