Credits

API jobs require Mosaic Motion credits on the API key owner's account. AI agents connected over MCP can read their balance and buy credits themselves with the get_credit_balance, purchase_credits, and set_auto_topup tools — including autonomous service accounts that pay for their own usage.

Managing credits

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

Open motion.so

Credits are sold at $5 for 200 credits. As a rough rule of thumb, 200 credits = roughly 1-2 videos, and 5,000 credits = roughly 18-20 videos. Longer videos, premium models, voiceover, and follow-up edits can use more.

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 1 credit in your balance.",
  "minimum_required_credits": 1,
  "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.