必须通过RESTful接口上传文件，不能使用网页端；需开通文档处理权限并确保API Key含document:write权限；用curl或Python requests提交二进制流，purpose设为agent；上传成功后获取file_id，在messages中以<file_id:xxx>格式引用，不可提前解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在MiniMax Agent中调用API上传文件供智能体解析使用，必须绕过网页端限制，直接通过RESTful接口提交二进制流，否则智能体无法在对话中访问该文件内容。
准备API调用凭证与环境
进入Minimax开发者控制台，确保当前项目已开通文档处理权限；未启用该权限的API Key即使格式正确也会返回403错误。
在【项目管理】→【API密钥管理】中复制有效密钥，【该密钥必须包含document:write权限】；若页面显示“无可用密钥”，需先点击【创建新密钥】并勾选对应权限范围。
打开终端，执行命令获取基础URL：curl -s "https://api.minimax.chat/v1/agent" -H "Authorization: Bearer sk-xxx" | jq -r '.base_url'，将返回值记为后续请求目标地址。
构造并发送文件上传请求
方法一：使用curl一次性上传（适合单文件调试）
执行以下命令，将your_file.pdf替换为本地路径，sk-xxx替换为实际密钥：
curl -X POST "https://api.minimax.chat/v1/files" \-H "Authorization: Bearer sk-xxx" \-F "file=@./your_file.pdf" \-F "purpose=agent"
响应体中若含"id": "file_xxx"且"status": "uploaded"，表示文件已成功注册，可被Agent引用。
方法二：使用Python requests库（适合批量或集成场景）
安装依赖：pip install requests；编写脚本时注意必须设置files参数为元组形式：('file', open('doc.txt', 'rb'))，不能传入字符串路径。
关键代码段：
import requestsurl = "https://api.minimax.chat/v1/files"headers = {"Authorization": "Bearer sk-xxx"}files = {"file": open("report.md", "rb")}data = {"purpose": "agent"}res = requests.post(url, headers=headers, files=files, data=data)print(res.json()["id"]) # 输出类似 file_abc123
在Agent对话中引用上传的文件
第一步：获取上传成功的file_id，它形如file_7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2，长度固定为32位十六进制字符。
第二步：构造messages数组，在任意user消息的content字段中插入<file_id:file_abc123>标记，例如：{"role":"user","content":"请基于<file_id:file_abc123>分析用户反馈趋势"}。
第三步：调用Agent对话接口时，【必须在请求Body中保留file_id标记，不可提前解析为文本或删除】；系统会在服务端自动提取该ID关联的原始文件内容注入上下文。
第四步：发起对话请求，观察响应中是否出现对文件内具体段落的引用，如“根据PDF第3页表格数据显示…”——若仅泛泛而谈，则说明file_id未被识别或文件解析失败。
