概览

SoMark 文档智能解析 API 基础信息、认证方式与接口列表

​

Base URL

https://somark.tech/api/v1

​

认证

所有接口均通过请求体中的 api_key 字段传入 API 密钥，格式为 sk-***。

# multipart/form-data 示例
-F "api_key=sk-your-api-key"

​

接口列表

接口	方法	路径	说明
同步解析	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 停用，请在此之前迁移至新路径。

​

使用限制

文件大小

单文件最大 200MB

页数限制

单次最多 300 页

调用频率

Beta 阶段 QPS 1（每账号）

​

支持的文件格式

pdf png jpg jpeg bmp tiff jp2 dib ppm pgm pbm gif heic heif webp xpm tga dds xbm doc docx ppt pptx

​

可识别的文档元素

标题

title

文字段

text

图片

figure

图例

figure_caption

表格

table

表例

table_caption

公式

equation

页眉

header

页脚

footer

侧边栏

sider

脚注

footnote

目录

cate

目录条目

cate_item

选项

choice

代码段

code

填空空白

blank

参考文献

reference

二维码

qrcode

印章

stamp

化学结构式

cs

化学方程式

cs_equation

​

错误码

所有接口返回统一的 code 字段，非 0 时表示出错。完整错误码列表见错误码参考。