跳转到主要内容

注册指南

若您是首次使用,需要先在 MiniMax 开放平台进行注册。 企业团队注册时,建议采用主账号+子账号的形式创建和管理。
  • 个人注册:若您是单人使用,直接在 MiniMax 开放平台 进行注册即可
  • 企业团队注册:若您是多人业务团队进行使用,建议采用主账号+子账号的形式进行管理
    1. MiniMax 开放平台 注册一个账号(此账号即为主账号,注册时填写的姓名与手机号会成为本企业账号的管理员信息)
    2. 登录该主账号,在 账户管理 > 子账号,创建您所需要数量的子账户(子账号的创建数量暂时没有限制)
    3. 为您企业的人员,分配不同的子账户,进行登陆使用

主账号与子账号的关系:

  • 子账号和主账号享用相同的使用权益与速率限制,子账号和主账号的 api 消耗可以进行共享,最后进行统一结算
  • 子账号的限制:子账号无法查看和管理“支付”页面的查看与管理,也无法进行子账号、以及子账号的接口密钥的管理操作

快速体验大模型

MiniMax 开放平台 API 调试台:更轻松、便捷。 若您希望直接体验到大模型的魅力,可以前往 API 调试台快速体验最新模型与功能。

快速接入

本示例基于 Python 3,帮助您快速接入 MiniMax 开放平台体验中心的对话能力,您需要完成以下步骤:

1. 获取鉴权信息

( 1 ). 通过 账户管理 > 账户信息 > 基本信息,获取 group_id 获取 group_id ( 2 ). 通过 账户管理 > 接口密钥,获取 API Key。 点击“创建新的密钥”,在弹窗中输入密钥的名称,创建成功后,系统将展示 API Key。请务必复制并妥善保存,该密钥只会显示一次,无法再次查看。 获取 API Key

2. 导入密钥信息

在使用 API 调用模型之前,需要先将 API Key 配置到环境变量中,避免在代码中明文出现,从而降低泄漏风险。 如您是 macOS/Linux 用户 ( 1 ). 打开终端,输入以下命令,将 <MINIMAX_API_KEY> 替换为您在第一步获取的密钥信息。
export MINIMAX_API_KEY="<MINIMAX_API_KEY>"
( 2 ). 执行以下命令,验证该环境变量是否生效,若返回您的 API Key,则表示设置成功。
echo $MINIMAX_API_KEY
如您是 Windows 用户
  • 在 CMD 中
( 1 ). 打开 CMD (命令提示符),输入以下命令,将 <MINIMAX_API_KEY> 替换为您在第一步获取的密钥信息。
set MINIMAX_API_KEY=<MINIMAX_API_KEY>
( 2 ). 执行以下命令,验证该环境变量是否生效,若返回您的 API Key,则表示设置成功。
echo %MINIMAX_API_KEY%
  • 在 PowerShell 中
( 1 ). 打开 PowerShell,输入以下命令,将 <MINIMAX_API_KEY> 替换为您在第一步获取的密钥信息。
$env:MINIMAX_API_KEY = "<MINIMAX_API_KEY>"
( 2 ). 执行以下命令,验证该环境变量是否生效,若返回您的 API Key,则表示设置成功。
$env:MINIMAX_API_KEY

3. 复制完整代码并执行

以下是一份可以在 Python3 终端环境中直接执行的完整代码,可将代码复制进 example.py 文件中。 注意:添加 import readline 引用是为了解决在中文输入下,Python 的 input 接口在删除字符时错误处理的问题。
import os
import requests
import readline

api_key = os.environ.get("MINIMAX_API_KEY")

url = "https://api.minimaxi.com/v1/text/chatcompletion_v2"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
    }

request_body = {
    "model": "MiniMax-M1",
    "tokens_to_generate": 8192,
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."}
    ]
}

while True:
    line = input("User input: ")
    if line.lower() in ['quit', 'exit']:
        break

    request_body["messages"].append({"role": "user", "content": line})

    response = requests.post(url, headers=headers, json=request_body)
    response_data = response.json()
    reply = response_data["choices"][0]["message"]["content"]
    reasoning_content = response_data["choices"][0]["message"]["reasoning_content"]
    print(f"Reasoning: {reasoning_content}")
    print(f"Reply: {reply}")

    request_body["messages"].append({"role": "assistant", "content": reply})
在终端中执行命令,运行代码:
python example.py

代码分步解析

如果您想进一步了解上述完整代码是如何逐步构建的,您可以继续阅读以下详细步骤解释。
1. 构建请求头
下面代码根据鉴权信息构建请求头(api_key 为您的密钥信息)。
url = "https://api.minimaxi.com/v1/text/chatcompletion_v2"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
    }
2. 构建请求内容
request_body 部分为构建初始请求体,初始化与模型交互的请求参数。获取用户输入后,将用户输入添加至请求体中。
request_body = {
    "model": "MiniMax-M1",
    "tokens_to_generate": 8192,
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."}
    ]
}
line = input("User input: ")
request_body["messages"].append({"role": "user", "content": line})
3. 完成交互
通过 requests 库提供的 post 能力对 API 进行调用,获取模型的推理内容和输出内容。 注意:每一轮回复内容都需要追加到 messages 中,这样才能在多轮的对话中记住对话历史。
response = requests.post(url, headers=headers, json=request_body)
response_data = response.json()

reply = response_data["choices"][0]["message"]["content"]
reasoning_content = response_data["choices"][0]["message"]["reasoning_content"]

request_body["messages"].append({"role": "assistant", "content": reply})
I