异步解析

适合多页 PDF 或批量任务。先提交获取 task_id,再轮询查询结果。

1. 提交任务

POST /api/v1/parse/async

参数与同步接口相同。

curl -X POST https://www.docparse4ai.com/api/v1/parse/async \
  -F "file=@document.pdf" \
  -F "api_key=sk-your-key" \
  -F "scene=general" \
  -F "output_formats=markdown"
# 响应
{
  "code": 0,
  "message": "任务已提交",
  "data": {
    "task_id": "a1b2c3d4...",
    "status": "QUEUING"
  }
}

2. 轮询结果

POST /api/v1/parse/async_check

参数类型必填说明
api_keystringAPI 密钥
task_idstring提交时返回的任务 ID

状态说明:

  • QUEUING — 排队等待
  • PROCESSING — 处理中,继续轮询(建议间隔 3~5s)
  • FAILED — 失败,查看 message / error 字段
  • SUCCESS — 成功,result 字段含解析结果
curl -X POST https://www.docparse4ai.com/api/v1/parse/async_check \
  -F "api_key=sk-dev" \
  -F "task_id=YOUR_TASK_ID"

队列后端

默认使用内存队列。配置 REDIS_URL 后自动切换 Redis 队列,需额外启动 python worker.py