Credits

MuAPI uses a credit-based system to meter API usage. Credits are purchased in advance and deducted per generation.

Your Credit Wallet

Every account has a personal credit wallet. Your balance is visible on the Dashboard.

  • Credits never expire.
  • All AI generation tasks deduct credits at the time of generation.
  • File uploads are free but require a balance greater than 0.

Checking Your Balance

Via API:

GET /api/v1/account/balance
x-api-key: YOUR_API_KEY

Response:

{ "balance": 42.50 }

Via CLI:

muapi account balance

Topping Up

  1. Go to Dashboard → Billing → Add Credits.
  2. Choose an amount and complete Stripe checkout.
  3. Credits are added to your wallet immediately after payment.

Via API:

POST /api/v1/account/topup
{ "amount": 20 }

Returns a Stripe checkout URL.

Per-Request Cost in API Responses

Every generation API response includes the actual cost charged to your wallet for that request:

{
  "request_id": "abc123",
  "status": "processing",
  "cost": {
    "amount_usd": 0.0042,
    "amount_credits": 1,
    "bonus_credits_used": 0,
    "refunded": false
  }
}

The same values are exposed as response headers (X-MuAPI-Cost-USD, X-MuAPI-Cost-Credits, X-MuAPI-Cost-Bonus-Credits) along with X-Account-Balance so agents can track spend without polling the balance endpoint. See API Reference.

Usage History

Your full usage log is available in the Dashboard. Each entry shows:

  • Model used and endpoint called
  • Credits deducted
  • Request ID and timestamp
  • Input parameters and output URLs

Free Credits

New accounts receive a small free credit allocation to get started.

See Also