MiniMax 是国内常见的多模态模型平台，覆盖文本、语音、视频等能力。很多团队在客服、内容生成、语音交互场景会用到它。

本文讲清楚 MiniMax API 的获取、调用方式和接入注意事项。

说明：MiniMax 是其权利人的商标。本文以 2026 年 10 月的常见版本为例，接口和价格以官方/站内为准。

一、MiniMax API 常见能力

  • 文本对话、写作、总结。
  • 语音合成/语音识别（视模型而定）。
  • 视频生成（视模型而定）。
  • Agent/工具调用。
  • 多模态输入。

不同模型的能力差异较大，使用前先看当前模型列表和参数。

二、获取 Key

官方 MiniMax

在 MiniMax 开放平台注册、创建 Key、充值。适合能直接使用官方平台的团队。

中商起航网关

  1. 注册 中商起航 AI 网关。
  2. 创建 API Key，设置额度。
  3. 充值。
  4. 按站内文档选择模型和接口。

注意：不是所有 MiniMax 能力都走 OpenAI 兼容协议。文本模型通常可以；语音/视频可能是任务式接口，需要单独适配。

三、文本模型调用

如果网关提供 OpenAI 兼容入口：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="minimax-text",
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(resp.choices[0].message.content)

模型名以 模型价格 为准。

四、语音/视频接口

语音/视频通常是异步任务：

  1. 提交任务，拿到任务 ID。
  2. 轮询状态。
  3. 成功后下载结果。

这类接口与 OpenAI Chat Completions 不同，不能直接套用聊天 SDK。使用前确认：

  • 是否支持异步任务。
  • 回调/轮询方式。
  • 文件大小/时长限制。
  • 结果保留多久。

五、接入测试清单

  1. 文本请求/流式。
  2. 工具调用（如支持）。
  3. 语音/视频任务提交与轮询。
  4. 长文本/大文件限制。
  5. 并发和限流。
  6. 账单核对。

六、常见问题

现象 原因 处理
401 Key 错/地址不匹配 检查 Key 和 Base URL
404 接口路径不对 按官方/站内文档
模型不可用 模型名/权限 查价格页/开通情况
任务一直处理中 排队/文件过大 降低大小、稍后重试
429 限流 降并发、重试

七、成本控制

  • 文本：按输入/输出 Token。
  • 语音：按时长/字符。
  • 视频：按秒/分辨率/任务。
  • 失败重试也会产生成本。

先小额测试，确认单价和成功率，再批量。

常见问题

MiniMax API 兼容 OpenAI 吗？

文本部分通常提供兼容接口；语音/视频多为独立任务接口，以官方文档为准。

国内访问稳定吗？

MiniMax 是国内平台，通常比海外模型稳定；具体以你的网络和区域为准。

可以同时接 Claude/GPT 吗？

可以，用统一网关即可一个 Key 调多个模型。

下一步

需要统一入口、按量计费和多模型切换，可以先 注册中商起航 AI 网关，小额测试文本和语音/视频能力。模型和价格以 模型价格 为准。

相关阅读：