MiniMax Agent调用报401或1004错误,通常因GroupID误传:新版v2接口(如/v1/chat/completions)无需传GroupID,其已绑定在Bearer Token中;旧版v1接口(如/v1/text/chatcompletion?GroupId=xxx)才需将GroupID拼在URL末尾,且仅识别query参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

MiniMax Agent调用时明明已填入GroupID却仍报401或1004错误,说明GroupID未被正确识别或根本不需要传——这通常发生在新旧接口混用、配置位置错误或密钥区域不匹配的场景中。
先确认你用的是哪个接口版本
新版v2接口(如/v1/chat/completions)完全不需要传GroupID,它已绑定在Bearer Token里;旧版v1接口(如/v1/text/chatcompletion?GroupId=xxx)才必须把GroupID拼在URL末尾。若你用新版路径却硬塞GroupID进query参数,服务端会直接忽略并因鉴权链断裂返回401。
打开MiniMax控制台→「模型服务」→点开你要调用的模型(如abab6.5s-chat),看「接入方式」标签页里写的endpoint路径:带?GroupId=的属于旧版,不带的属于新版。
新版路径示例:https://api.minimax.chat/v1/chat/completions;旧版路径示例:https://api.minimaxi.com/v1/text/chatcompletion?GroupId=123456789。
旧版接口:GroupID必须拼在URL里,且不能错位
方法一:手动构造完整URL
第一步:从控制台复制原始endpoint路径,例如https://api.minimaxi.com/v1/text/chatcompletion;
第二步:在末尾添加?GroupId=并接上你的GroupID数字(不是字符串,不加引号),例如?GroupId=987654321;
第三步:确保整个URL里只有这一处问号,不能出现?xxx&GroupId=或?GroupId=123&GroupId=456这种重复或拼接错误。
帮助用户满足已验证的需求:代理用户在Clawhub上对类似浏览器的工作流程需求强烈,需要实际的帮助来修复Bug、强化系统。
方法二:用代码动态拼接(Python示例)
url = f"{base_url}/text/chatcompletion?GroupId={group_id}";注意group_id变量必须是整数或纯数字字符串,不能是None、空字符串或含空格的字符串。
⚠️ 如果你在旧版接口里把GroupID塞进Authorization头、请求体或headers里,它压根不会被读取——旧版只认URL query参数。
新版接口:删掉所有GroupID相关字段
第一步:检查请求URL,确认路径是/v1/chat/completions或/v1/text/chatcompletion_v2这类不含GroupId的格式;
第二步:删除代码中所有显式传GroupID的地方——包括query参数、body字段、自定义headers;
第三步:确保Authorization头严格为Bearer your_api_key_here,中间一个空格,前后无换行无空格;
第四步:验证API Key来源域名是否与base_url一致——来自minimaxi.com的Key只能配api.minimaxi.com,来自minimax.chat的Key只能配api.minimax.chat,跨域必报401。

















