> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chunkr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Limits

> Task timeouts and file size restrictions.

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](mailto:support@chunkr.ai) 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.

<CodeGroup>
  ```python Python theme={"system"}
  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')
  ```

  ```typescript TypeScript theme={"system"}
  import ChunkrAI from "chunkr-ai";
  import fs from "fs";

  const client = new ChunkrAI({ apiKey: process.env.CHUNKR_API_KEY! });

  // Recommended for large files - use URL directly
  const task = await client.tasks.parse.create({
    file: "https://chunkr.ai/very-large-file.pdf",
  });
  ```
</CodeGroup>

***

## 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.