Rate Limits#

HTMLPix uses monthly quotas, not per-second throttling. There are two quota types:

• Image mints — consumed by POST /v1/url and POST /v1/urls
• AI template generations — consumed by POST /v1/templates/generate

Plan limits#

How quotas work#

• Only successful operations count. Failed requests (4xx/5xx) don't consume quota.
• Image delivery is free. GET /v1/image serves cached images at no cost, regardless of how many times it's fetched.
• Usage resets monthly on your billing cycle (UTC).
• Check your usage anytime in the dashboard.

Handling 429 errors#

When your quota is exhausted, the API returns 429:

{
  "code": "QUOTA_EXCEEDED",
  "message": "Monthly quota of 500 URLs minted exceeded"
}

For AI generation:

{
  "code": "QUOTA_EXCEEDED",
  "message": "AI generation quota exceeded"
}

What to do:

• Upgrade your plan for higher limits.
• Wait for your monthly reset if you don't need more capacity immediately.

Concurrent requests#

There is no hard per-second rate limit. However, concurrent mint requests near your quota boundary may race — some may succeed while others get 429 QUOTA_EXCEEDED.