异步解析

​

适用场景

• 提交接口：POST /parse/async
• 查询接口：POST /parse/async_check

​

标准流程

1. 调用 POST /parse/async 提交文件，拿到 task_id
2. 每隔 3~5 秒调用 POST /parse/async_check 查询状态
3. 当状态为 success 时，读取 data.result.outputs

​

请求示例

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"

​

轮询建议

• 轮询间隔建议为 3~5 秒，避免过于频繁请求
• 对失败状态设置重试次数和退避策略
• 将 task_id 与业务请求关联，便于追踪任务状态

​

进一步阅读

• 异步提交接口
• 异步查询接口