> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# API Overview
> Base URL, authentication, endpoint list, and error codes for SoMark Document Intelligence API
## Base URL
```
https://somark.cn/api/v1
```
The original URL `https://somark.tech/api/v1` remains valid. For best performance and future feature support, migrate to the new endpoint as soon as possible.
## Authentication
All requests pass the API key via the `api_key` field in the request body in `sk-***` format.
```bash theme={null}
# multipart/form-data example
-F "api_key=sk-your-api-key"
```
## Endpoints
Use [sync parsing](/en/api-reference/endpoint/sync) 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](/en/api-reference/endpoint/async-submit) first and then poll the [result query](/en/api-reference/endpoint/async-check) endpoint with `task_id` for a more reliable workflow. You can inspect remaining quota through [Usage Query](/en/api-reference/endpoint/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 unified `code` field. A non-zero value indicates an error. See the full [Error Codes reference](/en/api-reference/errors).