详情

首页手游攻略 MiniMax Agent GroupID获取做法

MiniMax Agent GroupID获取做法

佚名 2026-08-14 10:09:21

必须先获取Agent的唯一GroupID才能配置API调用或权限管理,否则因X-Group-ID缺失导致403/404错误;可通过控制台URL提取、GET /v1/agents接口查询或创建Agent响应体直接获取。

要在MiniMax平台为Agent配置API调用或权限管理,必须先获取该Agent对应的唯一GroupID,否则无法在请求头中正确设置X-Group-ID字段,导致403或404错误。

通过MiniMax控制台查看GroupID

第一步:登录MiniMax开发者控制台,使用已实名认证的账号。

第二步:在左侧导航栏点击「Agent」→「我的Agent」,进入Agent列表页。

第三步:找到目标Agent,点击其名称或右侧「详情」按钮,跳转至Agent详情页。

第四步:在详情页URL中直接提取GroupID——地址形如https://www.php.cn/link/5216918203d50dcfccc84a970b3743f0/agent/{group_id}/detail【{group_id}部分即为你要的GroupID,长度为24位十六进制字符串,例如65a1b2c3d4e5f67890123456

通过API接口获取GroupID(需已有AccessToken)

方法一:调用GET /v1/agents接口

https://api.minimaxi.com/v1/agents发送带Authorization头的GET请求,Header中包含Authorization: Bearer {your_access_token}

响应体中每个Agent对象含group_id字段,匹配namedescription即可定位目标Agent。

注意:该接口默认只返回前20个Agent,若列表过长,请添加limit=100&offset=20参数分页拉取。

通过创建Agent时的响应体获取(适用于新创建Agent)

调用POST /v1/agents创建Agent后,响应体JSON中group_id字段会直接返回,例如:

{"id":"agt_abc123","group_id":"66b2c3d4e5f6789012345678","name":"客服助手","status":"active"}

这一步操作起来很简单,直接复制响应里的group_id值即可使用,无需额外查找。

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载