调用MiniMax Agent需先获取Agent ID和API密钥，再构造含有效凭证与结构化消息体的HTTP POST请求；支持curl快速验证、Python requests同步调用及Java OkHttp方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让自有系统调用MiniMax Agent生成的智能应答，必须构造符合规范的HTTP POST请求，携带有效凭证与结构化消息体，否则会返回401或400错误。
获取Agent ID和API密钥
这两项是调用身份的硬性前提，缺一不可，且仅在控制台首次生成时完整可见。
第一步：登录Minimax开发者控制台，使用已实名认证的手机号或邮箱。
第二步：点击左侧【Agent】→【创建Agent】，选择“通用对话型”模板，填写名称并输入系统提示词，点击【保存并发布】。
第三步：在Agent详情页复制显示的【Agent ID】（格式如agt_XXXXXXXX）和测试Token（或使用项目级API Key）。
第四步：进入【项目管理】→【API密钥管理】，确认已有有效密钥；若无，点击【创建新密钥】，复制以sk-开头的字符串，并【立即保存至离线安全位置】——页面关闭后无法再次查看。
用curl命令快速验证调用
适合开发初期快速检验Agent是否就绪，无需写代码，5秒内可完成端到端验证。
打开终端，执行以下命令（将YOUR_API_KEY和YOUR_AGENT_ID替换成实际值）：
curl -X POST "https://api.minimax.chat/v1/text/chatcompletion"
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"agent_id": "YOUR_AGENT_ID",
"messages": [
{"role": "user", "content": "你好"}
]
}'
注意：Windows PowerShell用户需改用双引号包裹整个JSON，并对内部双引号转义；Mac/Linux直接运行即可。
Python调用实现（requests库）
这是生产环境最常用的方式，稳定、易调试、便于集成进Flask/Django等框架。
为 AI 代理注册和管理 ICANN 域名，支持钱包认证（SIWE/SIWS），可在 Base 或 Solana 上使用 USDC 支付，提供完整 DNS 管理。
方法一：基础同步调用
确保已安装requests：pip install requests
新建python文件，填入以下代码：
import requests
import json
url = "https://api.minimax.chat/v1/text/chatcompletion"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx"
}
payload = {
"agent_id": "agt_xxxxxxxxxxxxxx",
"messages": [
{"role": "user", "content": "请用中文简要介绍你自己"}
]
}
response = requests.post(url, headers=headers, json=payload)
if response.status_code == 200:
print(response.json()["choices"][0]["message"]["content"])
else:
print("Error:", response.status_code, response.text)
这一步操作起来很简单，直接把文件拖进去就行。但务必检查response.status_code是否为200，否则直接读取content字段会触发KeyError。
Java调用（OkHttp方式）
适用于需要精细控制超时、重试、日志埋点的企业级Java项目。
① 在pom.xml中添加依赖：
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>4.12.0</version>
</dependency>
② 构造并发送请求：
OkHttpClient client = new OkHttpClient();
String json = "{\"agent_id\":\"agt_xxxxxxxxxxxxxx\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}";
RequestBody body = RequestBody.create(json, MediaType.parse("application/json"));
Request request = new Request.Builder()
.url("https://api.minimax.chat/v1/text/chatcompletion")
.post(body)
.header("Authorization", "Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx")
.header("Content-Type", "application/json")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
String responseBody = response.body().string();
JsonObject obj = JsonParser.parseString(responseBody).getAsJsonObject();
String content = obj.getAsJsonArray("choices")
.get(0).getAsJsonObject().get("message")
.getAsJsonObject().get("content").getAsString();
System.out.println(content);
}
}
注意：OkHttp默认不支持JSON解析，需额外引入Gson或Jackson；此处使用Gson示例，需同步添加gson依赖。
