MiniMax API 设置:密钥、Base URL 和首次请求
这是 minimaxapikey.com 上 OpenAI 兼容 API 的分步设置:账户、密钥、Base URL、首次请求。这是一个独立服务,不是任何模型供应商的官方 API。
更新于

要点
- 使用 Google 或电子邮件注册,然后在密钥页面领取 $0.50 的免费试用额度。无需信用卡。
- Base URL 是 https://api.minimaxapikey.com/v1 ,模型 ID 是 uncensored,认证方式为 Bearer 密钥。
- 有两种方法:POST /v1/chat/completions 和 GET /v1/models。
- 401 表示密钥错误,429 表示达到限制,请检查响应体中的错误代码。
你正在设置的内容
人们搜索 minimax api setup 通常期望两种结果之一:官方 MiniMax 开发者平台,或即插即用的 OpenAI 风格接口。本页介绍后者。minimaxapikey.com 背后的服务是一个托管的、OpenAI 兼容的文本 API,运行单个开放权重模型,由独立运营商提供。它不是 MiniMax 或任何其他模型供应商的官方 API,也不跨供应商路由请求。如果你需要供应商自己的平台,请访问其网站。
你获得的服务很简单。更改 Base URL 和密钥后,任何 OpenAI SDK 或客户端均可使用。有两种方法,POST /v1/chat/completions 和 GET /v1/models,一个模型 ID uncensored,以及由提示词和补全共享的 100,000-token 上下文窗口。仅支持文本,因此没有图像、音频或视频生成,没有嵌入也没有微调。支持流式输出、函数调用和 JSON 模式。
整个设置只需几分钟。以下步骤按顺序进行,每一步都有检查,以便你在继续之前确认其有效。
步骤 1 和 2:创建账户并领取试用
- 打开密钥页面。 前往 API 密钥页面 并登录。你可以使用 Google,或电子邮件地址和密码。
- 领取试用额度。 登录后,密钥页面有一个按钮可领取 $0.50 的免费试用额度。只需一键,无需信用卡,有效期 7 天,每人限领一次。
试用额度较小是出于故意。输入 token 每 1M 个 $0.15,输出 token 每 1M 个 $0.50,$0.50 足以覆盖大量测试请求。1,000 token 的提示词加上 500 token 的回答,输入成本为 $0.00015,输出成本为 $0.00025,总计 $0.0004。用 $0.50 除以该金额可得 1,250 次此类请求,因此你有充足的空间进行实验。
注意试用密钥的限制:2 个并发请求和每分钟 60 个请求。完整密钥(充值后获得)允许 8 个并发请求和每分钟 300 个请求。如果你的测试循环并行运行并看到 429 错误,这是首先要检查的。
步骤 3:创建密钥并安全存储
在同一页面创建 API 密钥并复制。将其视为密码。将其放入环境变量或密钥管理器中,不要放在仓库、前端包或截图中。如果密钥泄露,请移除并创建新密钥。
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
服务器端代码应在运行时读取变量。浏览器代码不应持有密钥:应从后端发送请求,因为任何发送到浏览器的内容对所有访问者都是可见的。
步骤 4:列出模型以确认密钥
最便宜的测试是模型接口。它不生成文本,因此是对密钥、URL 和网络连接的干净检查。
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
你应该获得一个包含 uncensored 的 JSON 列表。如果得到 401,则密钥错误或周围有多余空格或引号。如果连接失败,请检查 URL 是否以 /v1 结尾,以及是否使用了 https。
步骤 5:发送首次聊天请求
现在进行真正的补全。请求体为标准聊天补全格式。
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
回复包含 choices[0].message.content 和包含提示词和补全 token 计数的 usage 块。也请查看响应头,使用 curl -i。你将看到 X-Request-Id,支持团队可用其查找你的请求,X-Balance-USD 是你的剩余额度,以及速率限制头 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。
temperature、top_p、stop、seed 等参数以及惩罚项会原样传递。max_tokens 是可选的。如果未指定,补全可以使用上下文窗口中剩余的所有 token。
步骤 6:通过 SDK 发送相同调用
curl 工作后,切换到你实际使用的语言。与标准 OpenAI 设置相比,只有两个参数会更改。
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
流式输出时,添加 stream: true 并读取服务器发送的事件。API 用量数据在流结束时返回。文档页面涵盖了流式输出、函数调用和 JSON 模式,以及 response_format: {"type":"json_object"}。
迁移现有的 OpenAI 项目
大多数情况下,你要连接的项目已经可以使用 OpenAI 的客户端库。在这种情况下,你几乎不需要编辑代码。当你不传递参数时,官方 SDK 会读取环境变量 OPENAI_API_KEY 和 OPENAI_BASE_URL,因此部署更改可能就足够了。
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
剩下的唯一编辑是模型名称。OpenAI 模型 ID 等字符串在此处不存在,因此将其替换为 uncensored,最好通过配置值进行替换,以便你可以切换回去。然后阅读代码中该服务未提供的功能。图像生成、音频、嵌入和微调不可用,因为这是一个仅文本的聊天 API。如果你的应用调用嵌入进行搜索,你需要另一家提供商来处理该部分,并可以在此处保留聊天。
了解模型也有帮助。它是一个单独的开放权重模型,针对合法成人用途进行了无内容拒绝优化,并且有一个硬性限制适用于所有设置:禁止涉及未成年人的性内容。为其他模型编写的提示词可能需要小幅调整,因为每个模型对相同系统提示词的反应不同。在切换真实流量之前,并排运行你自己的测试提示词。
第一天值得选择的设置
在设置时做出一些决定比在发布后更容易。它们都不难,但每个决定都能避免日后的意外。
- 系统提示词。 将关于语气、格式和角色的说明放入
system消息中。保持简短具体,因为每个请求都会将其作为输入 token 重复。 - Token 上限。
max_tokens是可选的,但设置上限是一种低成本的安全措施。如果没有上限,单个回答可能会消耗 100,000 token 上下文窗口中的剩余部分。 - 交互式使用的流式输出。 如果有人在等待回复,请设置
stream: true。对于批处理作业,普通请求更简单。 - 429 的重试规则。 将 429 视为等待信号,而不是失败。当响应包含
Retry-After: 5时,休眠该时长并重试是正确的做法。 - 请求大小。 主体限制为 8 MB。这远超正常提示词的需求,但粘贴的日志或文档可能达到此限制。
提示词不用于训练,如果你计划发送内部文档或用户消息,这很重要。你仍对发送的内容负责,因此避免将模型不需要的密钥放入提示词中。
试用后充值
试用用于检查一切是否正常工作。当你准备构建时,添加预付额度。没有订阅:你按使用的 token 付费,输入 token 每 1M 个 $0.15,输出 token 每 1M 个 $0.50,且额度永不过期,因此未使用的余额不会在月底消失。
$20 到 $500 之间的任意整数金额均可。$50 充值增加 5% 奖金,$100 增加 10%,$200 增加 15%。作为一个快速示例,$100 充值加上 10% 奖金提供 $110 的额度。根据步骤二中 1,000 token 提示词和 500 token 回答,每次请求成本为 $0.0004,因此 $110 可覆盖 275,000 次请求。实际提示词通常更长,因此根据你的平均情况调整该数字。
修复常见设置错误
| 症状 | 可能原因 | 修复方法 |
|---|---|---|
| 每次调用都返回 401 | 缺失、拼写错误或已撤销的密钥 | 发送 Authorization: Bearer <key>,不带额外引号 |
| 404 或 HTML 响应 | 路径错误,通常缺少 /v1 | 使用以 /v1 结尾的完整 Base URL |
| 未找到模型 | 从其他提供商复制的模型名称 | 使用 uncensored |
429 带有rate_limited | 超过每分钟请求数上限 | 放慢速度,或充值以从试用限制切换到完整限制 |
429 错误对应 concurrency 限制 | 同时请求过多 | 将并行调用限制为 8(试用密钥为 2) |
429 且 Retry-After: 5 | 临时过载 | 等待 5 秒并重试 |
| 413 或请求体被拒绝 | 请求超过 8 MB | 精简提示词或拆分任务 |
当你准备好使用试用额度之外的服务时,定价页面列出了充值选项:金额从 $20 到 $500 的任意整数,支持加密货币(TRC20 链上的 USDT、Base 链上的 USDC)支付,$50 起赠 5%,$100 起赠 10%,$200 起赠 15%。失败或被拒绝的请求不会扣费,且提示词不会用于训练。
更多指南
问答
这是 MiniMax 的官方 API 吗?
不是。这是一个独立的托管式 OpenAI 兼容 API,服务于单一开放权重模型,针对合法成人用途进行了优化,可在无内容审查的情况下回答。它不是任何模型供应商的官方 API,也不是跨供应商的路由服务。
试用需要信用卡吗?
不需要。注册后,你可以在 API 密钥页面一键领取 $0.50 的免费试用额度。该额度有效期为 7 天,每人限领一次。
请求中使用的模型名称是什么?
使用 uncensored。该服务仅提供此单一模型 ID,GET /v1/models 将显示该模型。
稍后如何增加额度?
充值金额可为 $20 至 $500 之间的任意整数金额。充值 $50 起赠送 5%,$100 起赠送 10%,$200 起赠送 15%,且预付额度永不过期。
我可以使用 OpenAI SDK 吗?
可以。将 base_url 设置为 https://api.minimaxapikey.com/v1 ,使用你的 API 密钥,并发送模型 uncensored。你的代码中无需其他更改。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改Base URL。这就是全部设置。