MiniMax Agent API 必须使用 https://api.minimax.chat/v1 域名和 "Bearer group_id:api_key" 认证;请求需含 model、messages 字段;响应中 content 在 choices0["content"],流式需设 stream:true 并解析 SSE。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要用 MiniMax Agent 的 API 接口快速生成一段可运行的代码,但官方文档只给参数说明、没给完整示例,不知道怎么拼请求、怎么处理响应、怎么填 auth token。
确认接口地址和认证方式
打开 MiniMax 官方文档页面,找到你正在调用的 Agent 接口(例如 /v1/chat/completions),确认它属于 【Agent 专属域名 https://api.minimax.chat/v1】,不是通用大模型的 https://api.minimax.ai/v1;混用会导致 404 或 401 错误。
在「Authentication」章节里找到 【Authorization header 必须用 Bearer + group_id:api_key 组合字符串】,不是单独的 api_key,也不是 token 前加 Minimax-。group_id 是你在控制台创建项目时分配的 32 位小写字母+数字串,必须和 api_key 用英文冒号连接。
构造最小可行请求体
方法一:用 curl 直接测试(适合调试)
复制以下命令,把 your_group_id 和 your_api_key 替换为你自己的值,粘贴到终端执行:
curl -X POST "https://api.minimax.chat/v1/chat/completions" \-H "Content-Type: application/json" \-H "Authorization: Bearer your_group_id:your_api_key" \-d '{"model": "abab6.5s", "messages": [{"role": "user", "content": "你好"}]}'
方法二:Python requests 版(适合集成进项目)
新建一个 minimax_agent.py 文件,写入:
import requestsurl = "https://api.minimax.chat/v1/chat/completions"headers = { "Content-Type": "application/json", "Authorization": "Bearer your_group_id:your_api_key"}data = { "model": "abab6.5s", "messages": [{"role": "user", "content": "你好"}]}resp = requests.post(url, headers=headers, json=data)print(resp.json())
解析返回 JSON 并提取回复内容
第一步:检查响应状态码是否为 200
第二步:读取 resp.json() 中的 choices[0]["message"]["content"] 字段,这是 Agent 实际输出的文本;如果直接取 resp.json()["content"] 会报 KeyError,因为顶层没有这个字段。
第三步:注意 response 字段可能为空字符串或 null——这表示 Agent 主动拒绝回答(比如触发安全策略),此时不能当作超时或网络错误重试,应直接提示用户“该请求未被允许”。
第四步:若需流式响应,把请求体中加上 "stream": true,然后用 resp.iter_lines() 逐行解析 SSE 数据,每行以 data: 开头,需手动 strip 并 json.loads 去掉前缀。


















