Credits
Get credits
Retrieve the authenticated user's credit balances, plan, next refill date, and the credit packs they can buy.
payPerUseBalance and subscriptionBalance keep their original meaning; the other fields were added later and are safe to ignore.
Generating (Creative Studio and AI Lab runs) requires an active plan: check subscribed. Pay-per-use credits stay on the account without a plan and can be spent once the user subscribes.
Requires an API key with the read scope.
Authorization
bearerAuth AuthorizationBearer <token>
API key authentication. Create a key in your Account settings.
Pass the full key in the Authorization header:
Authorization: Bearer vsl_...Keys are shown only once at creation. Treat them like passwords.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/credits"{ "balance": 112.5, "subscriptionBalance": 100, "payPerUseBalance": 12.5, "subscribed": true, "plan": { "family": "premium", "interval": "month", "monthlyCredits": 100, "cancelsAtPeriodEnd": false }, "refillsAt": "2026-11-24T09:12:00.000Z", "canBuyPacks": true, "packs": [ { "credits": 10, "priceEur": 6, "perCreditEur": 0.6 }, { "credits": 50, "priceEur": 20, "perCreditEur": 0.4 } ]}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}{ "error": { "code": "missing_api_key", "message": "string" }}