Skip to main content
Chunkr is designed for high-throughput processing. In general there are minimal limits, but there are a few considerations that are discussed here.

​
Task Timeout

All tasks have a 1-hour timeout once processing begins. Tasks that exceed this timeout will automatically fail. If you have a file that consistently times out, please contact our support team to discuss potential solutions.

​
Rate Limiting

To ensure fair usage and system stability, we enforce a rate limit of 10 files per second. If you exceed this limit, our API will respond with a 429 Too Many Requests error. Our SDKs are designed to handle this gracefully. They will automatically detect 429 errors and retry the request after a short backoff period.

​
File Size Limits

There are no hard limits on the size of the files you can upload. However, there is one exception:
  • Base64 Uploads: When uploading a file as a base64-encoded string, the total request size is limited to 1GB. This is a practical limit to ensure reliable transfer over HTTP.
If you need to upload files larger than 1GB, we recommend using a URL. 
from chunkr_ai import Chunkr
import os

client = Chunkr(api_key=os.environ['CHUNKR_API_KEY'])

# Recommended for large files - use URL directly
task = client.tasks.parse.create(file='https://chunkr.ai/very-large-file.pdf')

​
Page Limits

There is a soft limit of 2,000 pages per single file. We accept larger files, but they may fail to process. For documents exceeding this limit, please split the file into multiple parts before uploading.