跳转到主要内容

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

可识别的文档元素

https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E6%A0%87%E9%A2%98.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=e3e4fc73a7465bf0c6451dc3a0338095

标题

title
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E6%96%87%E5%AD%97%E6%AE%B5.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=12299c6659cfb8c3b959f3b674448caf

文字段

text
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%9B%BE%E7%89%87.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=0855fb1d50ef6f311b821a3a211fad42

图片

figure
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%9B%BE%E4%BE%8B.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=1df4efbb7cedfaa28f52bed0a27bb750

图例

figure_caption
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%A1%A8%E6%A0%BC.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=d8cf3f723e865ac5e800ac5d607f2ef7

表格

table
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%A1%A8%E4%BE%8B.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=55399e36e6299e2eb3ec14123d06e8b0

表例

table_caption
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%85%AC%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=67f3b05a7dd82641f97f1f6617a87e2a

公式

equation
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%A1%B5%E7%9C%89.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=a5b06d360c0dab4375067bd41b5f85ab

页眉

header
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%A1%B5%E8%84%9A.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=a9c1f47f6a5012fc4f74e3975eba6c08

页脚

footer
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BE%A7%E8%BE%B9%E6%A0%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=b275a97fc233d74422ad64f0b785f895

侧边栏

sider
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E8%84%9A%E6%B3%A8.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=d6432c312a7606eac70b78275434066a

脚注

footnote
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E7%9B%AE%E5%BD%95.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=bdddd0c059370efacffb2aaa9a0e09aa

目录

cate
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E7%9B%AE%E5%BD%95%E6%9D%A1%E7%9B%AE.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=9ed56458871e3ca1feeeee72470d5409

目录条目

cate_item
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E9%80%89%E9%A1%B9.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=edf4fbbadda32e3266c465dcede7f24c

选项

choice
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BB%A3%E7%A0%81%E6%AE%B5.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=64bf2e0b11ef8bd52569f7ee0a9ff959

代码段

code
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%A1%AB%E7%A9%BA%E7%A9%BA%E7%99%BD.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=f288a777c1077d4a3a8433b06a2ff021

填空空白

blank
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=000002e0c48dc1f7df9869dd3979e4df

参考文献

reference
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E4%BA%8C%E7%BB%B4%E7%A0%81.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=1264055d3c4053bdf03be668ee532e75

二维码

qrcode
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8D%B0%E7%AB%A0.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=74981c5e8a7e0511c54100e7a9a5a1b2

印章

stamp
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8C%96%E5%AD%A6%E7%BB%93%E6%9E%84%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=7a822a52b2bfd50fa8f3943559b4cdb7

化学结构式

cs
https://mintcdn.com/sc-d9e86e75/GqiRzvlW7yPf36pr/images/%E5%8C%96%E5%AD%A6%E6%96%B9%E7%A8%8B%E5%BC%8F.png?fit=max&auto=format&n=GqiRzvlW7yPf36pr&q=85&s=63fd0b8e80f48077dc5ef1d21739ceeb

化学方程式

cs_equation

错误码

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