Credits

API jobs require Mosaic Motion credits on the API key owner's account.

Managing credits

Purchase credits and configure auto top-ups in the Motion web app:

Open motion.so

Credit purchasing and auto top-up settings are not available through the API.

How credits apply to API jobs

Every public API job is owned by the user who created the motion_ API key. Credit checks and usage are applied to that user's Mosaic Motion account.

If the account does not have enough credits, the API may return an insufficient credits error when the job starts or during generation.

Insufficient credits response

{
  "error": "insufficient_credits",
  "code": "insufficient_credits_minimum_kickoff_balance",
  "message": "Starting a new Mosaic Motion session requires at least 300 credits in your balance.",
  "minimum_required_credits": 300,
  "current_balance": 0
}

To resolve this, add credits or enable auto top-ups in the Motion frontend at motion.so, then create a new job or retry when credits are available.