中文 ▾

MiniMax API 设置:密钥、Base URL 和首次请求

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

更新于

从密钥到服务器机架的六个发光步骤,代表 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:创建账户并领取试用

  1. 打开密钥页面。 前往 API 密钥页面 并登录。你可以使用 Google,或电子邮件地址和密码。
  2. 领取试用额度。 登录后,密钥页面有一个按钮可领取 $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。这就是全部设置。

获取 API 密钥