> ## Documentation Index > Fetch the complete documentation index at: https://docs.somark.ai/llms.txt > Use this file to discover all available pages before exploring further. # 概览 > SoMark 文档智能解析 API 基础信息、鉴权方式与接口列表 ## Base URL ``` https://somark.ai/api/v1 ``` ## 鉴权所有接口均通过请求体中的 `api_key` 字段传入 API 密钥，格式为 `sk-***`。 ```bash theme={null} # multipart/form-data 示例 -F "api_key=sk-your-api-key" ``` ## 接口列表如果你需要在一次请求里直接拿到结果，优先使用[同步解析](/api-reference/endpoint/sync)，适合交互式调用、小到中等文件、需要立刻展示结果的场景。如果文件较大、页数较多、处理时间可能较长，或者你要做批量任务、后台任务编排，优先使用异步解析：先提交[异步任务](/api-reference/endpoint/async-submit)，再通过 [结果查询](/api-reference/endpoint/async-check) 基于 `task_id` 轮询结果，更稳妥，也更容易做重试和队列控制。额度和账号状态可通过[用量查询](/api-reference/endpoint/usage-query)查看。 | 接口 | 方法 | 路径 | 说明 | | ---- | ---- | ------------------------------------- | ------------------------------ | | 同步解析 | POST | `/parse/sync` | 上传文件或提交文件链接，立即返回解析结果 | | 异步解析 | POST | `/parse/async` + `/parse/async_check` | 上传文件或提交文件链接，再基于 `task_id` 轮询结果 | | 用量查询 | POST | `/usage` | 查询当前 API 密钥的剩余额度与账号信息 | **路径迁移提示**：自本版本起，所有解析接口路径从 `/extract/` 变更为 `/parse/`。旧路径（`/extract/acc_sync`、`/extract/async`、`/extract/async_check`）将于 `2026-12-31` 停用，请在此之前迁移至新路径。 ## 使用限制 * 文件来源：请上传 `file`，或填写 `file_url` 文件下载链接；请勿同时提供两项。`file_url` 需为可直接打开或下载文件的公开链接或有效预签名链接 * 文件大小：单文件最大 **200MB** * 页数限制：单次最多 **300 页** * 调用频率：**QPS 4**（每账号） ## 支持的文件格式 `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` ## 可识别的文档元素