智谱清言多文档识别失败主因是并发超限或格式冲突；单次限3个文件且总大小≤15MB，混传不同格式或非线性化PDF均会导致静默失败，需统一转PDF、清理元数据、规范命名，或调用API绕过限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
智谱清言多文档识别失败时，页面通常只显示“识别失败”或“处理异常”，不提示具体错误类型，用户反复上传PDF/Word/Excel却始终卡在第一步——这往往不是模型服务宕机，而是多文件并行解析触发了平台的隐性并发限制或格式冲突。
确认是否超出并发上限
智谱清言对多文档识别有明确的并发阈值：单次最多支持3个文件同时上传，且总大小不能超过15MB。超过任一条件即静默拒绝，不报错也不提示。
打开浏览器开发者工具（F12）→ 切换到Network标签 → 上传文件后观察请求列表 → 找到以“/v1/files/batch”开头的请求 → 查看Response内容。若返回{"code":400,"message":"batch size exceeded"}，说明已超限。
将待识别文件按大小排序，优先上传前3个；其余文件等待当前批次完成后再分批提交。
排查文件格式兼容性冲突
方法一：禁止混传不同格式文件
智谱清言多文档识别引擎要求所有上传文件必须为同一类型。若同时选中【report.pdf】+【data.xlsx】+【notes.docx】，系统会直接跳过解析，返回空结果。
方法二：统一转为PDF再批量上传
用WPS或Adobe Acrobat将Word、Excel、TXT全部另存为PDF（注意勾选“保留文本可选性”）→ 确保所有PDF属性中“内容可选择”为真 → 再一次性上传。
【关键前提】所有PDF必须为线性化（Linearized）格式，否则即使单个能识别，多文件并行时会因解析器初始化失败而整体中断。
修复文件元数据污染
第一步：清除PDF文档中的XMP元数据
用Adobe Acrobat打开任一待上传PDF → “文件”→“属性”→“描述”选项卡 → 点击“清除所有自定义属性” → “高级”选项卡 → 取消勾选“嵌入缩略图”“保留原始图像数据” → 保存。
第二步：剥离Office文档的隐藏修订痕迹
在Word中按Ctrl+Shift+E开启“修订”面板 → 点击“接受所有修订”→“比较”选项卡→“比较”→选择“无”→关闭所有修订标记 → 另存为新文件。
第三步：重命名文件避免特殊字符
将文件名中的空格、括号、中文顿号、emoji全部替换为下划线，例如“2024年Q3_销售报表_v2.pdf” → 重新上传。
绕过前端限制直传API
如果你已有智谱AI官方API Key且权限正常，可跳过网页界面，用curl命令强制提交：
打开终端，执行以下命令（替换YOUR_API_KEY和实际文件路径）：
curl -X POST "https://open.bigmodel.cn/api/paas/v3/model-api/glm-4-flash/invoke" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: multipart/form-data" -F "file=@/path/to/file1.pdf" -F "file=@/path/to/file2.pdf"
该方式不受网页端并发数限制，但仅支持PDF格式，且单次最多5个文件。
