MiniMax API 调用实操：密钥配置与 Python 请求示例
MiniMax API 调用前需要准备什么
调用 MiniMax 大模型接口，准备三样东西即可：一个 MiniMax 开放平台账号、一个 API Key、以及你的 GroupId。
API Key 用于身份鉴权，GroupId 在部分接口的查询参数或业务字段中需要用到。
这两项都在开放平台控制台里创建和查看。
本文以 Python 的 requests 库为例，演示向 chatcompletion_v2 接口发送一次对话请求。
你不需要安装官方 SDK，用标准 HTTP 请求就能验证连通性。
开始前请确认本地 Python 版本不低于 3.7，并且能正常访问外网。
如果运行在服务器上，先确认出方向 443 端口没有被安全组或防火墙拦截。
获取密钥并跑通第一次请求
登录 MiniMax 开放平台，进入 API Key 管理页面，创建一个新的密钥并立即复制保存。
密钥通常只在创建时完整显示一次，关闭页面后无法再次查看明文。
GroupId 可以在账户信息或接口文档的示例中找到，后续请求参数会用到。
把密钥和 GroupId 写入环境变量，避免硬编码在代码里：
export MINIMAX_API_KEY="你的_API_Key"
export MINIMAX_GROUP_ID="你的_GroupId"然后创建一个 minimax_test.py，写入以下请求代码：
import os
import requests
api_key = os.environ["MINIMAX_API_KEY"]
group_id = os.environ["MINIMAX_GROUP_ID"]
url = f"https://api.minimax.chat/v1/text/chatcompletion_v2?GroupId={group_id}"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"model": "abab6.5s-chat",
"messages": [
{"role": "user", "content": "用一句话说明什么是 API"}
]
}
resp = requests.post(url, headers=headers, json=payload, timeout=30)
print(resp.status_code)
print(resp.text)执行 python minimax_test.py。
如果返回 200 且响应体里包含 choices 字段和模型回复内容，说明密钥、GroupId 和接口地址都配置正确。
模型名称请以你账号下实际可用的为准，这里使用的 abab6.5s-chat 只是示例。
常见报错怎么排查
返回 401 或鉴权失败：先检查 Authorization 请求头是否严格写成 Bearer 空格 密钥，密钥前后是否混入空格或换行。
其次确认密钥没有被删除或过期，可以在控制台重新生成一个再试。
返回 404：重点检查接口路径是否拼写正确。
本文示例使用 /v1/text/chatcompletion_v2，如果路径多写或少写字符，服务端会直接返回 404。
同时确认 GroupId 是作为查询参数附加在 URL 后面，而不是放在请求体里。
连接超时或无法解析域名：在服务器上执行 curl -I https://api.minimax.chat 看是否能建立连接。
如果卡住，检查 DNS 解析和出方向防火墙规则；
如果返回 SSL 相关错误，检查系统时间是否准确。
返回内容为空或提示模型不存在：确认 model 字段的值在你账号的可用模型列表中。
不同账号开通的模型权限可能不同，不要直接套用文档里的每一个模型名。
几个容易踩的坑
不要把 API Key 提交到 Git 仓库。
建议用环境变量或独立的配置文件加载，并在 .gitignore 中排除配置文件。
请求体必须使用 JSON 格式发送，Content-Type 要设为 application/json。
用表单方式提交会导致服务端解析失败。
messages 数组里的每条消息都要有 role 和 content 两个字段，角色通常是 user 或 assistant。
缺少字段可能返回参数错误。
生产环境调用时设置合理的 timeout，不要使用无限等待。
大模型响应时间受输入长度影响，超时时间建议不低于 30 秒，并根据实际场景调整。
确认调用成功的方法
除了看 HTTP 状态码，还要检查响应 JSON 中是否包含 choices[0].message.content。
可以打印 resp.json() 后逐层查看字段。
如果状态码是 200 但内容为空，先检查请求里的 messages 是否为空数组，或者模型是否返回了拒绝回答。
调用成功后，建议把请求封装成函数，统一处理密钥读取、超时和异常捕获，这样后续增加多轮对话时只需要维护消息列表。
MiniMax API 使用教程的核心就是密钥正确、路径正确、请求体格式正确，这三点验证通过后，剩余工作就是业务逻辑的接入。
