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

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

前往 somark.tech/workbench/apikey 获取 sk-*** 格式的 API Key。调用前只检查三件事：
  • 已传入 api_key
  • 文件不为空且格式受支持
  • output_formats 只使用 markdown、json、zip
免费用量规则见 免费规则。
2

先跑通一次同步解析

小文件先走 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"
3

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

大文件、批处理和后台任务走异步：先调 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 秒。
4

继续看详细接口文档