需开通文档解析权限、检查文件大小与格式、选择web/api/cli/手机端任一适配方式。具体包括:一、登录minimax平台开通文档解析服务;二、web端上传≤200页pdf或≤50mb word并启用结构化提取;三、api调用处理超大/批量文档,异步获取json结果;四、cli工具预处理复杂文档生成clean.txt再分析;五、app内直传pdf/docx/jpg/png,3–15秒完成解析与问答。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您尝试使用海螺AI对PDF、Word等文档进行内容理解与分析,但发现上传后无响应或提示格式不支持,则可能是由于未开通对应解析权限、文件超出限制或未选择适配模式。以下是解决此问题的步骤:
一、确认文档解析权限已启用
海螺AI的文档分析能力依赖Minimax平台后台的文档解析服务,未开通该权限时,系统将拒绝接收PDF/Word等非文本文件,或仅返回“格式不支持”提示,无法进入后续语义处理流程。
1、访问https://www.php.cn/link/403965e22c311cf3c37ebc98554b1ece并使用海螺AI关联账号登录。
2、在左侧导航栏点击“模型服务” → “文档解析”,检查状态栏是否显示已启用。
3、若显示“未开通”,点击“申请开通”按钮,并完成企业认证或开发者身份验证。
二、通过Web界面上传PDF与Word文件
该方式适用于单次处理≤200页、总大小≤100MB的PDF,以及≤50MB的DOC/DOCX文件,系统自动执行OCR识别(含扫描件)、文本层重建与语义分块,为问答提供可靠上下文基础。
1、进入Minimax文档解析控制台后,点击新建解析任务按钮。
2、在弹出窗口中点击“选择文件”,仅支持扩展名为.pdf、.doc、.docx的文件。
3、勾选启用结构化提取与保留页码索引两项选项。
4、点击“开始解析”,等待状态栏变为“已完成”,即可查看结构化结果或跳转至对话界面发起提问。
三、调用API接口处理超大或批量文档
适用于需集成至自有系统、日均处理量超50份文档的场景,支持异步提交与结果轮询,返回JSON格式的章节摘要、关键实体及引用定位。
1、在Minimax控制台的“API密钥”页面复制有效Secret Key,并记录Endpoint地址:https://api.minimax.io/v1/document/parse。
2、构造POST请求,Header中设置Authorization: Bearer {your_secret_key},Body为multipart/form-data格式,包含file字段(二进制文件)与mode字段(取值text或structure)。
3、收到202响应后,从返回的task_id字段提取ID,向/v1/document/result?task_id={id}发起GET请求,直至status字段为success。
四、使用命令行工具minimax-cli预处理复杂文档
针对含大量图像、加密保护、非标准字体或版式错乱的PDF/Word文件,可先在本地运行CLI工具完成文本清洗、布局还原与编码标准化,再上传纯文本片段至海螺AI进行深度语义分析。
1、执行命令pip install minimax-cli安装工具包。
2、运行命令minimax-cli pdf --input report.pdf --output clean.txt --layout,生成保留段落结构与图文位置关系的clean.txt。
3、将clean.txt拖入海螺AI对话框,直接发起分析、摘要或问答指令。
五、手机端App内直接上传与解析
海螺AI安卓/iOS官方App(v4.8.3+)支持本地文件直传,无需网页跳转,适配移动端操作习惯,且自动识别文件类型并匹配最优解析路径。
1、打开App后,点击首页【文档速读】入口。
2、点击右上角“+”号,选择“从手机相册/文件管理器选取”,支持PDF、DOCX、JPG、PNG等格式。
3、上传完成后,界面显示“正在解析…”状态标签,约3–15秒内完成文本提取。
4、解析完毕后,可点击“全文概览”查看摘要,或输入问题如“第3页提到哪些财务指标?”获取精准回答。










