Limits and formats
Use these limits when preparing documents, uploads, and media requests. API error responses identify requests that exceed a limit.
Documents and events
The following limits apply:
- Document title: 120 characters
- Account document list: Up to 200 per request
- Revision list: Up to 500 per request
- Event long poll: Up to 55 seconds
Uploaded document assets
Maximum upload size: 10 MiB per file.
Uploads support the following formats:
- Images: PNG, JPEG, GIF, WebP
- Video: MP4, WebM
- Audio: WAV, MP3, MP4 audio, Ogg, WebM audio
Node image generation
The following limits apply:
- Prompt: 2,000 characters
- Width: 256 to 1,536 pixels
- Height: 256 to 1,536 pixels
Dimensions are rounded and clamped to the supported range.
Node speech
The following limits apply:
- Text per request: 2,400 characters
- Voice description: 300 characters
The browser divides longer documents into chunks before submitting speech requests.
Node transcription
Maximum batch audio upload: 25 MiB per chunk.
Browser-recorded audio is normalized before submission. For external files, use a mono 16 kHz WAV file.
Node OCR
Maximum OCR image upload: 10 MiB.
The endpoint accepts browser image content types. OCR quality depends on resolution, layout, and the installed model.
Rate limits
Document creation allows 40 requests per caller IP in a 60-second window, shared across the homepage, /new, /api/docs, CLI, and MCP. Other limited API routes maintain their own budgets. A 429 response includes:
Retry-AfterX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset
To schedule retries, use the Retry-After header.