错误码
对齐 SoMark 官方错误码。所有接口返回统一格式，code 非 0 时表示出错，原因见 message 字段。
认证与授权
| code | 说明 |
|---|
| 1107 | 无效的 API Key |
| 1108 | 没有有效订单，请先购买套餐 |
| 1123 | 套餐剩余页数不足 |
频率限制
| code | 说明 |
|---|
| 1101 | 提取请求过于频繁 |
| 1124 | QPS 超限（Beta 阶段每账号 QPS 1） |
文件问题
| code | 说明 |
|---|
| 1104 | 不支持的文件类型 |
| 1106 | 无效或损坏的 PDF 文件 |
| 1111 | 文件不存在 |
| 1118 | 文件大小超出限制（最大 200MB） |
| 1132 | 文件超出 200MB/300 页限制，请分割后上传 |
参数错误
| code | 说明 |
|---|
| 1105 | 无效的输出格式 |
| 1133 | 参数错误（如 zip 输出时 image 必须为 file） |
任务错误
| code | 说明 |
|---|
| 1102 | 解析任务超时 |
| 1120 | 任务记录不存在 |
| 1137 | 解析任务失败（含 OCR 引擎显存不足） |
| 1138 | Office 文件转换失败 |
DocParse4AI 常见排查
- 1137 + internal error：MonkeyOCR 显存不足，重启 API 或减少页数，或改用
scene=k12 - 1123 额度不足：免费额度每日 500 页、每月 2000 页，次日刷新
- 1138 Office 转换失败：服务端需安装 LibreOffice
- K12 场景失败：确认 vl_ocr 布局（:30017）与 OCR（:30018）服务已启动