Usage Limits

Davix H2I applies usage limits to define how much work a request or plan can perform across the public API. These limits help keep processing stable and give developers clear operational boundaries when building against the platform.

Requests sent to Davix H2I are processed by the platform layer behind the product, including the H2I engine (PixLab) for rendering workflows. Usage limits affect request size, uploaded files, HTML rendering, PDF page operations, monthly quota, and request runtime behavior across the public API.

What this page covers #

This page is the canonical reference for customer-facing non-rate limits on:

  • POST /v1/h2i
  • POST /v1/image
  • POST /v1/pdf
  • POST /v1/tools

It covers:

  • monthly usage quota
  • per-file upload size
  • total upload size per request
  • maximum files per request
  • image dimension limits
  • H2I HTML and render limits
  • PDF page caps for supported actions
  • request timeout allowances

For request-frequency limits, use Rate Limits.

Usage limits by plan #

LimitFreeProBusiness
Monthly usage quota15010005000
Max files per request135
Max total upload per request5 MB15 MB30 MB
Max upload size per file5 MB15 MB30 MB
Request timeout20 seconds45 seconds60 seconds
Max image dimension2000 px4000 px6000 px
H2I max HTML size20,000 chars50,000 chars100,000 chars
H2I max render width2000 px4000 px6000 px
H2I max render height2000 px4000 px6000 px
H2I max render pixel area4,000,00016,000,00036,000,000
PDF max pages: to-images52050
PDF max pages: extract-images52050
PDF max pages: split52050
Image max files per request135
PDF max files per request135
Tools max files per request135
Image max total upload5 MB15 MB30 MB
PDF max total upload5 MB15 MB30 MB
Tools max total upload5 MB15 MB30 MB
Image max dimension2000 px4000 px6000 px
Tools max dimension2000 px4000 px6000 px

Monthly usage quota #

Customer API keys can have a monthly usage quota associated with their plan. This quota applies across the external API. When the quota has been exhausted, the API returns:

  • monthly_quota_exceeded
  • HTTP 429

The monthly quotas are:

  • Free: 150
  • Pro: 1000
  • Business: 5000

Use this limit to plan how many total operations a customer key can perform during the billing period.

File upload limits #

Upload-based endpoints enforce limits on:

  • individual file size
  • total upload size per request
  • number of files per request

These limits apply to:

  • /v1/image
  • /v1/pdf
  • /v1/tools

Relevant errors are:

  • file_too_large (413)
  • total_upload_exceeded (413)
  • too_many_files (413)

Upload limits by plan #

LimitFreeProBusiness
Max upload size per file5 MB15 MB30 MB
Max total upload per request5 MB15 MB30 MB
Max files per request135

H2I HTML and render limits #

The /v1/h2i endpoint enforces H2I-specific limits for HTML rendering requests.

Relevant error codes are:

  • html_too_large (413)
  • render_size_exceeded (400)

H2I limits by plan #

LimitFreeProBusiness
Max HTML size20,000 chars50,000 chars100,000 chars
Max render width2000 px4000 px6000 px
Max render height2000 px4000 px6000 px
Max render pixel area4,000,00016,000,00036,000,000

If the HTML payload exceeds the allowed size, the API returns html_too_large.

If the requested render size exceeds the allowed limit, the API returns render_size_exceeded.

Image dimension limits #

Uploaded images are subject to dimension limits on:

  • /v1/image
  • /v1/tools

When an uploaded image exceeds the allowed dimension limit, the API returns:

  • dimension_exceeded
  • HTTP 400

Dimension limits by plan #

Endpoint groupFreeProBusiness
Image uploads2000 px4000 px6000 px
Tools uploads2000 px4000 px6000 px

PDF page and action limits #

The /v1/pdf endpoint applies page caps for selected actions.

The supported page-capped actions are:

  • to-images
  • extract-images
  • split

When a page-capped action exceeds its limit, the API returns:

  • pdf_page_limit_exceeded
  • HTTP 413

PDF page caps by plan #

ActionFreeProBusiness
to-images5 pages20 pages50 pages
extract-images5 pages20 pages50 pages
split5 pages20 pages50 pages

Request timeout limits #

Each external /v1/* request is subject to timeout handling. When a request exceeds the allowed processing time, the API returns:

  • timeout
  • HTTP 503

Timeout allowances by plan #

PlanTimeout
Free20 seconds
Pro45 seconds
Business60 seconds

Temporary capacity limits #

Davix H2I also protects the platform with temporary processing-capacity controls. When the service cannot acquire processing capacity for a request, the API returns:

  • server_busy
  • HTTP 503

This is a temporary service-capacity condition rather than a plan allowance or validation limit. Client applications should treat it as a transient failure and reduce burst pressure or retry cautiously.

Usage limits are different from rate limits #

Usage limits and rate limits are separate:

  • Usage limits cover quota, upload size, file count, dimensions, H2I rendering limits, PDF page caps, and timeout allowances
  • Rate limits control how quickly requests can be accepted

For request-frequency controls, use Rate Limits.

How to use this page #

Use this page as the canonical reference for customer-facing non-rate limits. Other documentation pages should link here instead of repeating quota, file-size, render, page, or timeout values.

Was it helpful ?
Table of contents
Login
Login
Login
Login
Scroll to Top