Skip to main content

​
Rate Limiting

The PixCraft API uses monthly usage limits based on your plan. Usage is tracked per account (not per API key), and only pattern generation counts as a use.

​
Limits by plan

PlanMonthly usesWhen limit is reached
Starter500API and widget stop generating designs until the next month
Business2,000API and widget stop generating designs until the next month
EnterpriseUnlimited—

​
What counts as a use

Only generating a pattern/design counts as a use:
ActionCounts as use?
POST /api/v1/generate (generate pattern)Yes
Widget: user clicks “Generate”Yes
POST /api/v1/generate/pdf (download PDF)No
Widget load / validationNo
GET /api/v1/usageNo
GET /api/v1/capabilities, /niches, /colors, /healthNo

​
How it works

  • Usage is tracked at the account level — all your API keys and widgets share the same monthly counter
  • Usage resets on the 1st of each month
  • When you reach your limit, the API returns 429 RATE_LIMIT_EXCEEDED and the widget will not generate new designs
  • You will receive an email notification when you are close to your limit (~50 uses remaining)
  • You will receive another email notification when you reach the limit

​
Checking your usage

Call GET /api/v1/usage to see how many uses you have remaining: 
curl https://www.pixcraft.es/api/v1/usage \
  -H "Authorization: Bearer px_live_your_key"

{
  "calls_used": 243,
  "calls_limit": 2000,
  "calls_remaining": 1757,
  "reset_date": "2025-05-01"
}

​
Handling 429 errors

When rate limited, do not retry — the limit resets at the beginning of the next month. Instead, inform your users or upgrade your plan. 
const response = await fetch('https://www.pixcraft.es/api/v1/generate', { ... });

if (response.status === 429) {
  // Monthly limit reached — do not retry
  console.log('Monthly usage limit reached. Upgrade your plan or wait until next month.');
}

​
Best practices

  1. Cache results — If the same image + parameters are requested again, serve from cache instead of calling the API
  2. Monitor usage — Check /usage periodically and set up alerts when approaching your limit
  3. Use appropriate plans — If you consistently hit your limit, consider upgrading to avoid service interruptions