Skip to main content
Sandbox requests do not call providers and do not consume credits. Live requests process real images and consume paid API credits.

​
Live access requirements

To create live enhancements, the account must have: 
lifetime purchased credits >= 200
available paid credits >= required batch cost
Free signup credits and promotional credits are not API-live eligible. Live API enhancements use paid credits only.

​
Cost

Product image enhancement: 5 paid credits per image
Images in batchCredits required
15
525
20100

​
Reservation and consumption

When a live batch is accepted, AI Gen Studio reserves the required paid credits.
EventCredit behavior
Batch acceptedCredits are reserved for the full batch.
Item completedReserved credits for that item are consumed.
Provider, storage, queue, or timeout failureRefundable reserved credits are released for failed system-side items.
Invalid payload or rejected requestNo credits are reserved.
Sandbox requestNo credits are reserved or consumed.

​
Insufficient credits

If the account does not have enough paid credits for the full batch, the API returns 402 insufficient_api_credits. 
{
  "error": {
    "code": "insufficient_api_credits",
    "message": "You do not have enough API-eligible credits to process this batch. API enhancements can only use purchased credits.",
    "request_id": "req_..."
  }
}
Your integration should reduce the batch size or ask the account owner to purchase more credits before retrying.

​
Production billing model

For platform customers, the expected model is a business/API credit balance. The account purchases or receives an agreed pilot balance, then live API usage draws down that balance as images complete. Use sandbox for integration work before spending live credits.