Docs / Get started

Balance and top-ups

MiniAPI is prepaid. You add money, and each job's price comes out of your balance.

Add money

Add funds in the console with a card: $10, $25, $50, $100, or any whole amount up to $10,000. Money you add also moves you up the rate limit steps.

What a job costs

A job's price is fixed when you submit it, from the price list. To see it first, send the same body to the quote endpoint. A quote is free.

cURL
curl -X POST "https://api.minicut.ai/v1/quote/seedance-2.5" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a paper boat on a lake", "resolution": "720p", "duration": 5}'

When you submit, the price is set aside from your balance while the job runs. If the job completes, that is the charge. If it fails, is cancelled or expires, the money comes back. You are not charged for it.

Read your balance

cURL
curl "https://api.minicut.ai/v1/balance" \
  -H "Authorization: Key $MINIAPI_KEY"
FieldMeaning
balanceYour balance, with running jobs already taken out
heldIn use by running jobs
availableWhat you can spend now
lifetime_addedEverything you have added
month_spendSpent this month, against monthly_cap
currencyUSD. Every amount on this reply is in US dollars

A submit whose price is more than available answers 402 insufficient_balance and starts nothing.