Credits & Pricing

Understanding costs and optimizing your credit usage.

Credit Costs

What's Free

These operations cost zero credits:

• analyze-image - AI analysis of an uploaded image
• analyze-url - Website analysis and mascot suggestions
• suggest-actions - AI-suggested poses for a collection
• Style card extraction (automatic on first generation)
• Background removal (included in generation pipeline)
• Format conversion (webm, hevc from video)
• Size variants (resizing animations to multiple resolutions)

How Credits Work

Credits are deducted upfront when a generation job starts. If the job fails, credits are automatically refunded to your account.

Your account has two credit balances: subscription credits (replenished each billing cycle) and top-up credits (purchased separately, never expire). Subscription credits are used first.

Checking Your Balance

curl https://api.masko.ai/v1/credits \
  -H "Authorization: Bearer masko_YOUR_API_KEY"

Common Workflow Costs

Insufficient Credits

If you don't have enough credits, the API returns a 402 Payment Required response:

{
  "error": "Insufficient credits",
  "required": 21,
  "available": 5
}