MiniMax 按量付费通用API - 开源AI工具配置文档

本文档仅整理MiniMax 按量付费通用API（非Token Plan订阅Key）在主流开源编程/Agent工具的完整配置，区分OpenAI兼容、Anthropic兼容两套接口，覆盖CLI、VSCode插件、桌面IDE、Agent框架全品类工具。

基础通用配置

1. 接口地址（按量付费专用）

兼容协议	Base URL	适用工具类型
Anthropic兼容（推荐，缓存优化更好）	`https://api.minimaxi.com/anthropic`	Claude Code、OpenClaw、Claude桌面插件
OpenAI兼容	`https://api.minimaxi.com/v1`	Cursor、Cline、Kilo、OpenCode、Codex、TRAE、Dify

2. API Key 获取

登录MiniMax开放平台
控制台 → 接口密钥 → 创建新API Key
复制密钥（格式无固定前缀，与Token Plan订阅Key sk-cp-xxx 完全独立，不可混用）

3. 环境变量前置清理（必做）

配置前清除冲突环境变量，避免覆盖配置

bash

# macOS / Linux
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset OPENAI_BASE_URL
unset OPENAI_API_KEY

# Windows PowerShell
$env:ANTHROPIC_BASE_URL=""
$env:ANTHROPIC_AUTH_TOKEN=""
$env:OPENAI_BASE_URL=""
$env:OPENAI_API_KEY=""

4. 快速测试调用示例

Anthropic兼容测试

bash

curl https://api.minimaxi.com/anthropic/v1/messages \
-H "Authorization: Bearer 你的按量API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
  "model": "MiniMax-M3",
  "max_tokens": 2000,
  "messages": [{"role":"user","content":"你好"}]
}'

OpenAI兼容测试

bash

curl https://api.minimaxi.com/v1/chat/completions \
-H "Authorization: Bearer 你的按量API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "MiniMax-M3",
  "messages": [{"role":"user","content":"你好"}]
}'

终端CLI工具

一、Claude Code（Anthropic协议）

1. 安装

bash

npm install -g @anthropic-ai/claude-code
claude --version

2. 跳过初始化登录配置

文件路径

macOS/Linux：~/.claude.json
Windows：C:\Users\用户名\.claude.json

json

{
  "hasCompletedOnboarding": true
}

3. 核心配置 settings.json

路径：~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的按量API_KEY",
    "ANTHROPIC_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7-highspeed",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
    "CLAUDE_CODE_SUBAGENT_MODEL": "MiniMax-M3",
    "API_TIMEOUT_MS": "3000000"
  }
}

4. 使用

bash

cd 项目文件夹
claude
# 输入 /status 校验接口与模型是否生效

二、OpenCode（OpenAI协议）

1. 安装

bash

npm install -g opencode-ai
opencode --version

2. 一键登录配置

bash

opencode auth login
# 搜索选择 MiniMax（minimaxi.com）
# 粘贴按量付费API Key完成认证

3. 手动配置文件（备用）

路径：~/.config/opencode/opencode.json

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "minimax/MiniMax-M3",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MiniMax按量付费",
      "options": {
        "baseURL": "https://api.minimaxi.com/v1",
        "apiKey": "你的按量API_KEY"
      },
      "models": {
        "MiniMax-M3": {"limit":{"context":1000000,"output":65536}},
        "MiniMax-M2.7": {"limit":{"context":204800,"output":32768}},
        "MiniMax-M2.7-highspeed": {"limit":{"context":204800,"output":32768}}
      }
    }
  }
}

4. 启动

bash

opencode
# /models 切换模型

三、Codex CLI（OpenAI协议）

1. 安装

bash

npm i -g @openai/codex
codex --version

2. 配置文件 `~/.codex/config.toml`

toml

model = "MiniMax-M3"
model_provider = "minimax"

[model_providers.minimax]
name = "MiniMax按量API"
base_url = "https://api.minimaxi.com/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "responses"

3. 环境变量临时生效

bash

# macOS/Linux
export MINIMAX_API_KEY="你的按量API_KEY"
# Windows CMD
set MINIMAX_API_KEY=你的按量API_KEY

4. 启动

bash

codex

VSCode IDE插件

一、Cline（OpenAI兼容）

VSCode扩展市场搜索Cline安装（版本≥3.47.0）
打开插件 → Use your own API key
配置项填写值
API Provider MiniMax / OpenAI Compatible
MiniMax Entrypoint api.minimaxi.com
API Key 你的按量API_KEY
Model MiniMax-M3 / MiniMax-M2.7

配置项	填写值
API Provider	MiniMax / OpenAI Compatible
MiniMax Entrypoint	`api.minimaxi.com`
API Key	你的按量API_KEY
Model	MiniMax-M3 / MiniMax-M2.7

二、Kilo Code（OpenAI兼容）

VSCode搜索kilo code安装
Settings → Providers → Custom Provider
配置项值
API Provider OpenAI Compatible
Base URL https://api.minimaxi.com/v1
API Key 按量API_KEY
Model MiniMax-M3

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://api.minimaxi.com/v1`
API Key	按量API_KEY
Model	MiniMax-M3

三、Roo Code

扩展安装Roo Code
API Provider选择OpenAI Compatible
BaseURL：https://api.minimaxi.com/v1，填入API Key，模型填MiniMax-M3

桌面AI编辑器

一、Cursor（仅Pro+支持自定义接口）

打开Cursor → Settings → Models
开启Override OpenAI Base URL
OpenAI API Key填入按量API_KEY
Override地址：https://api.minimaxi.com/v1
Add Custom Model添加MiniMax-M3、MiniMax-M2.7

注意：Override是全局开关，切换官方GPT/Claude模型时需关闭

二、TRAE

打开TRAE设置 → 模型 → 添加模型
服务商选择「自定义OpenAI兼容」
BaseURL：https://api.minimaxi.com/v1
填入按量API_KEY，模型ID填写MiniMax-M3

开源Agent框架

一、OpenClaw（支持Anthropic优先）

1. 安装

macOS/Linux

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 手动配置 `~/.openclaw/openclaw.json`

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax-pay": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "你的按量API_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id":"MiniMax-M3","name":"MiniMax-M3","contextWindow":1000000,"input":["text","image"]
          },
          {
            "id":"MiniMax-M2.7","name":"MiniMax-M2.7","contextWindow":204800,"input":["text","image"]
          }
        ]
      }
    }
  },
  "agents": {"defaults":{"model":{"primary":"minimax-pay/MiniMax-M3"}}},
  "gateway":{"mode":"local"}
}

3. 重启网关生效

bash

openclaw gateway restart
# openclaw tui 终端界面 / openclaw dashboard Web面板

二、Hermes Agent

终端执行 hermes model
Select Provider 选择 MiniMax (global endpoint)
输入按量付费API Key
默认模型选择MiniMax-M3

CC Switch一键配置（可视化管理所有工具）

1. 安装

macOS

bash

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows：Releases下载安装包

2. 配置步骤

打开CC Switch → 右上角+添加供应商
预设选择MiniMax
API Key填入按量付费通用Key（不可填Token Plan订阅Key）
模型列表全部替换为MiniMax-M3/MiniMax-M2.7
点击添加 → 首页启用，自动同步Claude Code等工具配置

通用OpenAI兼容模板（Dify/Cherry Studio等）

适用于所有自定义OpenAI接口工具

参数	配置值
Base URL	`https://api.minimaxi.com/v1`
API Key	MiniMax按量付费密钥
模型	MiniMax-M3
请求路径	`/chat/completions`

Dify额外说明

模型供应商添加「Minimax」
API Base填https://api.minimaxi.com/v1
填入按量API Key，保存后绑定MiniMax系列模型

支持语言模型清单（按量付费可用）

Model ID	总上下文	定位
MiniMax-M3	1,000,000	旗舰，长代码库、复杂Agent推理
MiniMax-M2.7	204,800	通用编程、日常任务
MiniMax-M2.7-highspeed	204,800	极速响应，轻量问答
MiniMax-M2.5	204,800	高性价比通用任务
MiniMax-M2.5-highspeed	204,800	极速轻量
MiniMax-M2.1	204,800	多语言编码
MiniMax-M2.1-highspeed	204,800	极速编码
MiniMax-M2	204,800	基础编码Agent

多模态：M3、M2.7系列支持图片输入（VLM视觉理解）

关键注意事项

密钥区分
- 按量付费API Key：控制台「接口密钥」创建，本文全部工具使用此Key
- Token Plan订阅Key：sk-cp-xxx，仅订阅套餐抵扣，二者完全不互通，混用直接报错
协议区分
- Claude Code优先Anthropic地址，缓存成本更低
- 绝大多数IDE插件仅支持OpenAI/v1地址
环境变量冲突 系统全局ANTHROPIC_*/OPENAI_*变量会覆盖工具本地配置，使用前务必清空
计费规则 按量API按输入+输出Token实时扣费，无月度额度限制，无5小时滚动限额；Token Plan才有窗口限额
多模态扩展 MiniMax配套语音、图像、视频模型需单独调用对应API，AI编程工具仅调用语言模型
限流策略 按量付费TTPM更高，重度开发、多Agent并行优先选用通用按量API

官方文档：MiniMax 开放平台 API 接口

MiniMax 按量付费通用API - 开源AI工具配置文档 ​

基础通用配置 ​

1. 接口地址（按量付费专用） ​

2. API Key 获取 ​

3. 环境变量前置清理（必做） ​

4. 快速测试调用示例 ​

Anthropic兼容测试 ​

OpenAI兼容测试 ​

终端CLI工具 ​

一、Claude Code（Anthropic协议） ​

1. 安装 ​

2. 跳过初始化登录配置 ​

3. 核心配置 settings.json ​

4. 使用 ​

二、OpenCode（OpenAI协议） ​

1. 安装 ​

2. 一键登录配置 ​

3. 手动配置文件（备用） ​

4. 启动 ​

三、Codex CLI（OpenAI协议） ​

1. 安装 ​

2. 配置文件 ~/.codex/config.toml ​

3. 环境变量临时生效 ​

4. 启动 ​

VSCode IDE插件 ​

一、Cline（OpenAI兼容） ​

二、Kilo Code（OpenAI兼容） ​

三、Roo Code ​

桌面AI编辑器 ​

一、Cursor（仅Pro+支持自定义接口） ​

二、TRAE ​

开源Agent框架 ​

一、OpenClaw（支持Anthropic优先） ​

1. 安装 ​

2. 手动配置 ~/.openclaw/openclaw.json ​

3. 重启网关生效 ​

二、Hermes Agent ​

CC Switch一键配置（可视化管理所有工具） ​

1. 安装 ​

2. 配置步骤 ​

通用OpenAI兼容模板（Dify/Cherry Studio等） ​

Dify额外说明 ​

支持语言模型清单（按量付费可用） ​

关键注意事项 ​

关于本站

MiniMax 按量付费通用API - 开源AI工具配置文档

基础通用配置

1. 接口地址（按量付费专用）

2. API Key 获取

3. 环境变量前置清理（必做）

4. 快速测试调用示例

Anthropic兼容测试

OpenAI兼容测试

终端CLI工具

一、Claude Code（Anthropic协议）

1. 安装

2. 跳过初始化登录配置

3. 核心配置 settings.json

4. 使用

二、OpenCode（OpenAI协议）

1. 安装

2. 一键登录配置

3. 手动配置文件（备用）

4. 启动

三、Codex CLI（OpenAI协议）

1. 安装

2. 配置文件 `~/.codex/config.toml`

3. 环境变量临时生效

4. 启动

VSCode IDE插件

一、Cline（OpenAI兼容）

二、Kilo Code（OpenAI兼容）

三、Roo Code

桌面AI编辑器

一、Cursor（仅Pro+支持自定义接口）

二、TRAE

开源Agent框架

一、OpenClaw（支持Anthropic优先）

1. 安装

2. 手动配置 `~/.openclaw/openclaw.json`

3. 重启网关生效

二、Hermes Agent

CC Switch一键配置（可视化管理所有工具）

1. 安装

2. 配置步骤

通用OpenAI兼容模板（Dify/Cherry Studio等）

Dify额外说明

支持语言模型清单（按量付费可用）

关键注意事项