跳转到主要内容

​
注册指南

若您是首次使用，需要先在 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