必须先在Minimax开发者控制台创建项目和Agent获取Agent ID与API密钥，再用正确Header（Authorization、Content-Type、x-group-id）和JSON Body（含agent_id、messages等必填字段）调用POST接口，最后从响应choices[0].message.content提取文本。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想把MiniMax智能体能力快速集成进自己的系统，但卡在API调用第一步——连不通、收不到回复、返回401或400错误，根本不知道该填什么参数、从哪找凭证、请求体怎么写才合法。

获取Agent ID和API密钥

这一步必须在Minimax开发者控制台完成，跳过会导致后续所有请求直接失败。登录后必须先创建项目，再创建Agent，最后才能拿到两个关键凭证。

访问 https://platform.minimax.io，用已实名认证的手机号或邮箱登录。

进入控制台首页后，点击左上角【新建项目】，填写项目名称（如“客服系统对接”），描述可留空，点击确认。

左侧导航栏点击【Agent】→【创建Agent】，模板选“通用对话型”，命名如“售后问答助手”，系统提示词框里输入明确角色约束，例如：【你只回答订单查询、退货流程、物流时效三类问题，其他一律拒绝回答】。

点击【保存并发布】，页面跳转后，在Agent详情页顶部立即复制显示的Agent ID（以ag-开头的长字符串）；右侧“测试Token”下方点击【复制】，这就是临时可用的API密钥——注意：这个Token仅用于调试，正式环境必须切换为项目级密钥。

回到左侧菜单，进入【项目管理】→【API密钥管理】，确认已有有效密钥；若无，点击【创建新密钥】，填写名称（如“客服系统生产密钥”），生成后必须立刻全选复制sk-xxx格式密钥，并存到安全位置——关闭页面后无法再次查看。

构造标准POST请求

Minimax Agent API只接受HTTPS POST，且必须带认证头与结构化JSON载荷，少一个字段或格式错一位都会触发400错误。

Apidot Minimax Music 2 6 Api

使用APIDot进行MiniMax Music 2.6 API工作流程，包括AI音乐生成、歌词创作、器乐制作、音频导出规划、异步任务提交、任务ID...

下载

请求URL固定为：https://api.minimax.chat/v1/text/chatcompletion。

设置Header三项：
Authorization: Bearer 【你的sk-xxx密钥】
Content-Type: application/json
x-group-id: 【你在API密钥管理页复制的16位十六进制Group ID】（不是项目ID，也不是Agent ID）。

Body中提交JSON，必填字段只有两个：agent_id（粘贴上一步复制的ag-xxx）和messages（数组，至少含一条user消息）。示例：
{
  "agent_id": "ag-xxx",
  "messages": [
    {"role": "user", "content": "我的订单123456还没发货，能查下吗？"}
  ]
}

如果Agent在控制台未绑定默认模型，必须额外加model字段，值填abab6.5s或MiniMax-M2.7等具体型号；启用流式响应需显式设stream: false，否则返回SSE格式，前端解析会失败。

解析响应并提取内容

成功调用后返回HTTP 200状态码，响应体是标准JSON，但有效文本藏得深，直接渲染整个响应会出错。

第一步检查status code是否为200；若是4xx或5xx，读error.message字段，常见原因：密钥失效（401）、Agent未发布（404）、配额超限（429）、x-group-id错（401）。

第二步解析JSON，路径必须是choices[0].message.content，这是唯一要取的纯文本字段。其他字段如id、created、usage都无需处理。

若需多轮对话，把历史消息（含system、user、assistant角色）按时间顺序追加到messages数组末尾，总长度不能超过上下文窗口限制——超过会触发400错误且不提示具体超限位置。