​

Rate Limiting

​

Limits by plan

​

What counts as a use

​

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

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

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