异步解析
适合多页 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_key | string | 是 | API 密钥 |
| task_id | string | 是 | 提交时返回的任务 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。