MiniMax海螺新用户免费领15元代金券，可试全模态API

MiniMax 同时提供 OpenAI 兼容风格的接口和原生接口。文本对话的 base_url 形如 https://api.minimaxi.com/v1，完整请求地址为 https://api.minimaxi.com/v1/chat/completions；语音合成、视频生成使用各自的独立路径，具体地址以控制台「文档 / 快速开始」页面展示为准，不要凭记忆拼接。

第一步：配置密钥

把控制台创建的密钥写入环境变量，避免硬编码进代码仓库：

export MINIMAX_API_KEY="在控制台创建的接口密钥"

第二步：确认模型名

模型名请到控制台的模型列表或文档页复制当前可用的名称，文本对话类常见的有 MiniMax-M2、abab6.5s-chat 等，最终以控制台实际显示为准。

第三步：发起一次对话补全

下面的 curl 命令可直接复制运行。关键参数说明：model 指定要调用的模型；messages 是消息数组，system 用于设定角色与风格，user 是本次提问；temperature 控制随机性，取值越大越发散；max_tokens 限制回复长度；stream 为 true 时以流式方式返回增量内容。

curl https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M2",
    "messages": [
      {"role": "system", "content": "你是一名简洁的中文助手"},
      {"role": "user", "content": "用一句话说明什么是大模型 API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

返回体中 choices[0].message.content 就是回复文本，usage 字段一般包含本次消耗的 token 数，可用于估算成本。

第四步：用 SDK 调用

若项目里已装 OpenAI 官方 SDK，只需改 base_url 和模型名即可复用现有代码：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MINIMAX_API_KEY"],
    base_url="https://api.minimaxi.com/v1",
)

resp = client.chat.completions.create(
    model="MiniMax-M2",
    messages=[{"role": "user", "content": "写一句产品 slogan"}],
    temperature=0.7,
    max_tokens=256,
)
print(resp.choices[0].message.content)

额度耗尽与限流的典型表现

• 额度耗尽：请求返回余额不足或欠费类错误，控制台代金券显示已用完或已过期，此时同一账号下的调用会一并失败。
• 触发限流：返回 HTTP 429，或错误体中出现频率超限、并发超限的提示，多因短时间请求过密、并发过高。
• 鉴权失败：返回 401 或提示密钥无效，常见于密钥复制不全、首尾带空格或密钥已被删除。

排查顺序

1. 先看 HTTP 状态码与错误体中的错误码和提示文案，判断属于鉴权、限流还是余额问题。
2. 用同一条 curl 命令直接复现，排除业务代码的拼接问题；确认请求头是 Authorization: Bearer 加一个空格再加密钥。
3. 核对 base_url 与路径是否配套：兼容风格走 /v1/chat/completions，原生接口路径不同，混用通常直接返回 404。
4. 登录控制台查看代金券余额、有效期和计费明细，确认赠额是否已过期，或当前模型不在抵扣范围内。
5. 若判定为限流，降低并发并加入指数退避重试；若为额度问题，需充值或等待新的活动，赠额不会自动续期。