在Linux服务器上使用curl调用Minimax API需构造正确请求头、携带API Key或Access Token，并传递合法JSON载荷；支持直接鉴权、OAuth2获取Token及-v调试三种方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Linux服务器上使用curl命令行工具调用Minimax API进行接口测试，则需要正确构造HTTP请求头、携带有效认证凭证，并传递符合API要求的JSON载荷。以下是几种可行的操作方法：
一、使用API Key直接调用文本生成接口
该方法适用于已获取Minimax平台分配的API Key，且目标接口为/v1/chat/completion等支持API Key鉴权的端点。请求需设置Authorization头为Bearer格式，并确保Content-Type为application/json。
1、打开终端，确认系统已安装curl：运行curl --version验证版本不低于7.68.0。
2、执行以下curl命令，替换YOUR_API_KEY为实际密钥，YOUR_MODEL_NAME为Minimax提供的模型标识（如abab6.5s）：
curl -X POST "https://api.minimax.chat/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_NAME",
"messages": [
{"role": "user", "content": "你好"}
]
}'
二、通过临时Access Token方式调用（需先获取Token）
部分企业版或高权限场景下，Minimax可能要求使用OAuth2流程获取短期有效的Access Token。此方式需先向认证端点发起POST请求换取token，再将token用于后续API调用。
1、向https://api.minimax.chat/v1/token发送请求，传入client_id与client_secret（由Minimax控制台提供）：
curl -X POST "https://api.minimax.chat/v1/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "grant_type=client_credentials"
2、从返回JSON中提取access_token字段值，保存为变量：
ACCESS_TOKEN=$(curl -s -X POST "https://api.minimax.chat/v1/token" -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=YOUR_CLIENT_ID" -d "client_secret=YOUR_CLIENT_SECRET" -d "grant_type=client_credentials" | jq -r '.access_token')
3、使用该token调用聊天接口：
curl -X POST "https://api.minimax.chat/v1/chat/completions" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model":"abab6.5s","messages":[{"role":"user","content":"请简述量子计算原理"}]}'
三、启用调试模式查看完整请求细节
当响应异常或返回401/403错误时，需确认请求是否被篡改、Header是否遗漏或JSON格式是否合法。启用verbose输出可捕获完整的HTTP交互过程，包括请求头、响应头及状态码。
1、在原curl命令后追加-v参数启动详细日志模式：
curl -v -X POST "https://api.minimax.chat/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"abab6.5s","messages":[{"role":"user","content":"测试"}]}'
2、观察输出中> Authorization:行是否包含正确token前缀，是否出现，以及响应体是否含<code>"choices"字段。
四、处理常见错误响应并定位问题
Minimax API返回非2xx状态码时，响应体通常包含code与message字段。直接解析响应有助于快速识别原因，例如rate_limit_exceeded、invalid_api_key或model_not_found等。
1、将错误响应保存至临时文件以便检查：
curl -X POST "https://api.minimax.chat/v1/chat/completions" \
-H "Authorization: Bearer INVALID_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"abab6.5s","messages":[{"role":"user","content":"test"}]}' \
-o /tmp/minimax_error.json 2>/dev/null
2、读取错误内容：
cat /tmp/minimax_error.json | jq '.'
3、重点关注返回JSON中的<strong><font color="green">code</font></strong>字段值，对照Minimax官方文档错误码表确认含义。
