如何在Linux服务器通过Curl调用Minimax API 命令行测试方法【教程】-人工智能-PHP中文网

在linux服务器上使用curl调用minimax api需构造正确请求头、携带api key或access token，并传递合法json载荷；支持直接鉴权、oauth2获取token及-v调试三种方式。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如何在linux服务器通过curl调用minimax api 命令行测试方法【教程】

如果您希望在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')

MiniMax Provider 配置

为 OpenClaw 配置 MiniMax 作为模型源。MiniMax 提供两种接入方式：API Key 直连（openai-completions 协议）和 OAuth 门户（anthropic-messages 协议）。包含 provider 注册、模型定义、别名配置、fallback 链接入和验证的完整流程。当管理员说想"加 MiniMax"、"配 minimax"、"接入 MiniMax 模型"、"加海螺模型"、&qu

下载

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官方文档错误码表确认含义。