Skip to main content

​
What are credits?

Credits are the account balance BabySea uses for generation costs. The credit system stores balances as dollar-denominated values with three decimal places, so the dashboard and API can show precise amounts such as $0.052. BabySea prices models in the same unit: 1 credit = $1 USD.

​
How you get credits

SourceWhen it happensAmount
Welcome creditsAutomatically when a new account is created$1.000
Subscription planAdded through billing-backed credit allocationMatches the plan allocation
Credit packsPurchased from Billing$10, $25, $50, $100, $500, $1000

​
Plan allocations

The credits schema maps each paid plan price to a matching credit allocation:
PlanMonthlyYearly
Starter$9.000$90.000
Pro$29.000$290.000
Scale$99.000$990.000
Enterprise$199.000$1990.000
Welcome credits are granted once per user. The database enforces that one-time rule across accounts.

​
How credits are consumed

When you call POST /v1/generate/image/{model_identifier} or POST /v1/generate/video/{model_identifier}, BabySea follows a reserve-first flow:
1

Calculates the cost

BabySea resolves the model price from the model pricing configuration.
2

Reserves credits

BabySea atomically checks the account balance and deducts the required amount in a single operation.
3

Submits to provider

The generation is submitted to the provider flow.
4

Confirms or refunds

If the generation succeeds, BabySea records a charge ledger entry. If it fails after reservation, BabySea attempts a refund.
If your balance is too low for the generation cost, BabySea returns error BSE1004 (insufficient_credits) with HTTP 402 and the generation never starts. You can preview the cost of any generation before you generate. See Usage.

​
Credit properties

PropertyDetail
Unit1 credit = $1 USD
Precision3 decimal places (e.g. $0.052)
Failed generationsReserved credits can be refunded
Canceled generationsPending generations can refund reserved credits
Audit trailEvery credit operation is logged in the transaction ledger

​
Dashboard

Navigate to Credits in the sidebar to view your balance and ledger history. To purchase credit packs, go to Billing. The Credits page title is Credits and the page description is Track credits history.

​
Next steps

  • Balance - View your balance and purchase credit packs
  • Usage - How credits are consumed and the estimate API
  • Transactions - Read and search your credit transaction ledger
  • Best practices - Monitor spending and optimize costs