必须构造合法HTTP POST请求调用MiniMax Agent，需提供agent_id和API Key，缺一不可；须在控制台发布Agent后获取凭证，请求URL为https://api.minimax.chat/v1/text/chatcompletion，Header含Authorization和Content-Type，Body含agent_id与messages数组，响应中choices[0].message.content为有效文本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让自有系统调用 MiniMax Agent 的能力，必须构造合法的 HTTP POST 请求，传入 agent_id 和 API Key，并正确解析返回字段；直接复用 OpenAI SDK 配置或漏填关键字段会导致 401 或 400 错误，连基础响应都拿不到。
获取 Agent ID 和 API Key
这两项是调用 Agent 接口的硬性身份凭证，缺一不可，且必须在控制台发布 Agent 后才能拿到有效 ID。
登录 platform.minimax.chat，用实名手机号或邮箱进入开发者控制台。
左侧导航栏点击【Agent】→【创建Agent】，选择“通用对话型”模板，填写名称并输入系统提示词（例如：“你是一名电商客服，只回答订单、物流、售后类问题”），点击【保存并发布】。
发布成功后，在 Agent 详情页复制显示的 【Agent ID】（形如 agt-xxxxxx）和测试 Token（或使用项目级 API Key）。
进入【项目管理】→【API密钥管理】，确认已生成有效密钥；若未生成，点击【创建新密钥】并复制 sk-xxx 格式密钥，【立即保存至安全位置】——该密钥仅显示一次，丢失需重新生成。
构造标准 POST 请求
MiniMax Agent 接口不接受 GET 请求，也不支持 OpenAI SDK 默认 base_url 直接切换，必须手动构造完整请求。
请求 URL 固定为：https://api.minimax.chat/v1/text/chatcompletion。
为 AI 代理注册和管理 ICANN 域名，支持钱包认证（SIWE/SIWS），可在 Base 或 Solana 上使用 USDC 支付，提供完整 DNS 管理。
设置 Header 字段：Authorization: Bearer {your_api_key} 和 Content-Type: application/json。
Body 提交 JSON，必须包含以下字段：agent_id（填上一步复制的 ID）、messages（数组格式，至少含一个 {"role":"user","content":"你好"} 对象）。
注意：stream 默认为 true，若不需要流式响应，必须显式写 "stream": false；model 字段可不填——只要 Agent 已绑定默认模型，填了反而可能触发冲突校验。
解析响应并提取内容
成功调用返回 HTTP 状态码 200，响应体是标准 JSON 结构，但有效文本藏得深，不能直接渲染整个 response。
第一步：检查 status code 是否为 200；若为 4xx/5xx，根据 error.message 定位问题（常见如 “agent not published”、“invalid api key”、“quota exceeded”）。
第二步：读取响应体中 choices[0].message.content 字段值，该字段即为 Agent 生成的纯文本回复。
第三步：若需多轮对话，将历史消息（含 system、user、assistant 角色）按时间顺序追加至 messages 数组，总长度不能超过上下文限制——超长会直接被截断且不报错，只返回部分结果。
