要调用minimax agent需同时配置api key、base url和agent id——缺一不可；api key须注册认证后在密钥管理中创建并立即保存；agent需创建发布后才能获取id和测试token；base url固定为https://api.minimax.chat/v1/text/chatcompletion。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让程序能调用MiniMax Agent的AI能力，必须提前准备好身份凭证、服务地址和智能体标识，缺一不可——没有API Key无法通过鉴权，Base URL写错会直接连接失败，Agent ID漏填则返回404错误。
获取有效的API Key
登录 platform.minimax.io，用邮箱注册并完成实名认证；左侧导航栏点「API密钥管理」→「创建新密钥」→输入名称（如hermes-prod）→点击创建；【页面立即显示的sk-xxx密钥必须当场复制保存，关闭后无法再次查看】；注意账户需绑定支付方式或预充值，否则调用时会触发402错误。
创建并发布Agent实例
在控制台左侧点「Agent」→「创建Agent」→选择「通用对话型」模板；填写Agent名称（如售后助手），在系统提示词框中输入明确的角色定义，例如：“你只处理订单查询与退换货流程，不回答天气、股票等无关问题”；点击「保存并发布」后，页面跳转至详情页，此时可复制到Agent ID和测试Token；【未点击“发布”状态的Agent无法被API调用，调试页可用但HTTP接口返回404】。
确认三个核心参数
方法一：从控制台直接抄录
打开刚发布的Agent详情页，找到三项必填字段：
① Agent ID：以agt_开头的长字符串
② API Key：刚复制的sk-xxx密钥
③ Base URL：统一使用 https://api.minimax.chat/v1/text/chatcompletion（注意不是v1/chat/completions，后者不支持agent_id参数）
方法二：用Postman快速验证
新建POST请求，URL填上一步的Base URL；Header加两行：Authorization: Bearer sk-xxx 和 Content-Type: application/json；Body里写JSON：{"agent_id":"agt_xxx","messages":[{"role":"user","content":"你好"}]}；发送后若返回200且content有文本，说明三参数全部正确。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
