Base URL
Authentication
All requests pass the API key via theapi_key field in the request body in sk-*** format.
Endpoints
Use sync parsing when you need the result in the same request, such as interactive workflows, small to medium files, or UI flows that should return immediately. Use async parsing when files are larger, documents take longer to process, or you are building batch jobs or backend pipelines. In that case, submit the async task first and then poll the result query endpoint withtask_id for a more reliable workflow. You can inspect remaining quota through Usage Query.
| Endpoint | Method | Path | Description |
|---|---|---|---|
| Sync parsing | POST | /parse/sync | Upload a file and receive results immediately |
| Async parsing | POST | /parse/async + /parse/async_check | Submit a task and poll results using task_id |
| Usage Query | POST | /usage | Check remaining quota and account information for the current API key |
Path migration notice: All parsing endpoint paths have been changed from
/extract/ to /parse/. The old paths (/extract/acc_sync, /extract/async, /extract/async_check) will be discontinued on December 31, 2026. Please migrate to the new paths before then.Usage Limits
- File size: maximum 200MB per file
- Page limit: maximum 300 pages per request
- Rate limit: Beta QPS 1 per account
Supported File Formats
pdf png jpg jpeg bmp tiff jp2 dib ppm pgm pbm gif heic heif webp xpm tga dds xbm doc docx ppt pptx xlsx xlsm xls
Recognized Document Elements
Title
Text block
Figure
Figure caption
Table
Table caption
Equation
Header
Footer
Sidebar
Footnote
TOC
TOC entry
Choice
Code block
Blank
Reference
QR code
Stamp
Chemical structure
Chemical equation
Error Codes
All endpoints return a unifiedcode field. A non-zero value indicates an error. See the full Error Codes reference.