必须构造合法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。
将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成,支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。
设置 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 数组,总长度不能超过上下文限制——超长会直接被截断且不报错,只返回部分结果。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










