Group ID是团队级全局标识,用于旧版API认证(需拼在URL中),Application ID是应用级独立凭证,用于新版Agent服务(传入JSON body),二者位置、用途、传递方式均不同,混淆将导致401或invalid_application_id错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

区分MiniMax Agent的Group ID和Application ID是调用API前必须厘清的基础问题,二者在控制台位置、用途、传递方式上完全不同,混淆会导致401或403错误且难以定位。
Group ID:代表团队身份的全局标识
Group ID是Minimax为每个注册团队分配的唯一字符串,长度通常为16~32位数字或字母组合,在开发者控制台中全局可见,所有该团队下的API Key都共享同一个Group ID。
登录 platform.minimaxi.com → 进入「账户设置」或「API管理」页面 → 在页面顶部或「团队信息」区域直接看到一串类似 【1234567890123456】 的ID,这就是Group ID。
旧版接口(如 /v1/text/chatcompletion)必须将它作为 query 参数拼在URL末尾,例如:?group_id=1234567890123456;遗漏即报401,而非400,极易误判为Key失效。
Application ID:绑定具体应用的独立凭证
Application ID不是控制台自动显示的字段,而是你在创建某个具体AI应用(如客服Agent、语音合成服务)时手动填写并由系统生成的标识符,用于隔离不同业务线的调用配额、日志和权限。
进入控制台 → 点击左侧「应用管理」→ 点击「新建应用」→ 填写应用名称(如“智能外呼系统”)→ 提交后,系统自动生成一串以 app_ 开头的ID,例如 【app_xxxxxxx】,这个就是Application ID。
通过 4 个 Agent 半串行协作流水线(Plan/Write/Test/Refine)把老板的一句话需求转化为可用的 Python 软件,适用于用户说“做个软件”“开发工具”“写个脚本”或希望 AI 代理构建软件的情况。
它不参与HTTP请求头认证,仅在调用部分云端Agent服务(如OpenClaw托管Agent)时,需作为 application_id 字段传入请求体(JSON body)中;若错填成Group ID,服务会直接返回 invalid_application_id 错误。
如何快速验证自己拿对了哪个ID
第一步:打开浏览器开发者工具(F12)→ 切换到Network标签页 → 在控制台触发一次API调用(如测试发送消息)。
第二步:找到对应请求 → 查看Headers → 若Authorization头存在且URL中含 group_id=,说明你正在用旧版接口,此时Header里绝不能出现Application ID。
第三步:再找一次调用OpenClaw云端Agent的请求 → 查看Payload(Request Payload)→ 若JSON中明确包含 "application_id": "app_..." 字段,而URL里没有group_id参数,说明这是新版Agent服务调用路径,此时Group ID完全不需要出现在本次请求中。
注意:【同一账号下,Group ID固定不变;Application ID可无限创建,每个应用独享一个】。

















