SoMark API - SoMark 文档

适合直接调 HTTP 接口、自己控制请求参数、后端流程和结果处理的团队。如果你还在比较接入方式，先看入门总览；如果你要核对鉴权、限制和接口列表，再看 API 概览。

获取 API Key 并完成调用前检查

前往 somark.tech/workbench/apikey 获取 sk-*** 格式的 API Key。调用前只检查三件事：

已传入 api_key
文件不为空且格式受支持
output_formats 只使用 markdown、json、zip

免费用量规则见免费规则。

先跑通一次同步解析

小文件先走 POST /parse/sync。请求发出后，结果会直接在当前响应里返回。

curl -X POST https://somark.tech/api/v1/parse/sync \
  -F "file=@document.pdf" \
  -F "output_formats=markdown" \
  -F "output_formats=json" \
  -F "api_key=sk-your-api-key"

大文件改用异步提交和查询

大文件、批处理和后台任务走异步：先调 POST /parse/async 拿 task_id，再调 POST /parse/async_check 轮询状态。

curl -X POST https://somark.tech/api/v1/parse/async \
  -F "file=@large.pdf" \
  -F "output_formats=markdown" \
  -F "api_key=sk-your-api-key"

curl -X POST https://somark.tech/api/v1/parse/async_check \
  -F "task_id=your-task-id" \
  -F "api_key=sk-your-api-key"

轮询间隔建议保持在 3 到 5 秒。

继续看详细接口文档

入门总览 SoMark CLI

⌘I