Credits
Last updated
Blotato credits pay for AI generations such as videos and images. Use these endpoints to check your remaining credit balance, see current pricing, and buy more credits. Two endpoints:
Get Credit Balance — GET /v2/credits
Buy Credits — POST /v2/credits
Credits belong to a single account and are non-transferable. Confirm the account email from Get Credit Balance before you buy, so the credits land on the account you intend.
Base URL: https://backend.blotato.com/v2
URL: /credits
Method: GET
Returns your remaining credits, the email of the account the API key belongs to, and current purchase pricing.
Status Code: 200 OK
creditsRemaining
integer
Credits left on the account.
accountEmail
string
Email of the account the API key belongs to.
purchaseQuantityRange
object
Allowed purchase range, with min and max credits per purchase.
pricePer1000CreditsUsd
number
Price in US dollars per 1,000 credits.
Example response:
401
Missing or invalid API key.
500
Server error.
URL: /credits
Method: POST
Creates a Stripe Checkout link to buy credits. Creating the link does not charge anything. The account owner opens the link in a browser and completes payment there, and the purchased credits land on this account. Buy between 1,000 and 10,000 credits per request.
Confirm the account email from Get Credit Balance first, since credits are non-transferable between accounts.
quantity
integer
Yes
Credits to buy. Between 1,000 and 10,000.
referral
string
No
Optional referral code.
Status Code: 201 Created
checkoutUrl
string
Stripe Checkout URL. Open it in a browser to complete payment. No charge happens until checkout completes.
Example response:
400
The quantity is outside the 1,000 to 10,000 range, or the request body is invalid.
401
Missing or invalid API key.
429
Rate limit exceeded (10 requests per hour).
500
Server error.
Credits cost $6.00 per 1,000 credits. Read the current price from Get Credit Balance (pricePer1000CreditsUsd), since pricing changes over time.
Last updated
{
"creditsRemaining": 54688,
"accountEmail": "user@example.com",
"purchaseQuantityRange": { "min": 1000, "max": 10000 },
"pricePer1000CreditsUsd": 6.0
}{
"checkoutUrl": "https://checkout.stripe.com/c/pay/cs_test_123"
}