MiniMax M3

MiniMax-M3 是 MiniMax 最新的 M 系列多模态基础模型，专为智能体推理、工具使用、编程和长上下文任务而构建。它支持文本、图像和视频输入，并生成文本输出，同时提供 100 万 tokens 的上下文窗口、扩展思考、函数调用和结构化输出能力。凭借在长周期智能体工作流、软件开发、多模态理解和长回复生成方面的强大能力，MiniMax-M3 非常适合自主智能体、编程助手、文档与视频分析，以及以具有竞争力的成本处理超大上下文的生产级应用。

MiniMax M3

MiniMax M3 是 MiniMax 最新 M 系列多模态基础模型，面向 Agent 推理、工具调用、编码与长上下文任务。支持文本、图片、视频输入与文本输出，提供 100 万 token 上下文窗口、可配置思考模式、函数调用与结构化输出，适用于自主 Agent、编码助手、文档与视频分析及大规模上下文生产应用。

Base URL

https://api.icreat.ai/llm/openai/v1

认证

所有 API 请求需要通过 API Key 进行认证。您可以在控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护好您的 API Key

切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。

代码示例

本模型通过 OpenAI 兼容的 Chat Completions 接口调用，支持流式与非流式两种模式。请求体中将 stream 设为 false（默认）时，服务端一次性返回完整 JSON 响应；设为 true 时，以 Server-Sent Events（SSE）逐块推送增量内容，适合实时展示生成过程。

POST/chat/completions

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/llm/openai/v1/chat/completions \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-M3",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Coffee or tea? Which is healthier?"}
  ],
  "thinking": {"type": "enabled"},
  "reasoning_effort": "low",
  "stream": false
}'

输入参数

以下参数在请求体中被接受。

总计: 6 必填: 2 可选: 4

modelstring必填

用于补全的模型 ID。须填写 iCreat 的 model_code（本篇模型为 MiniMax-M3，非厂商原始模型名）。

Example: "MiniMax-M3"

messagesarray[object]必填

构成对话的消息列表。content 可为纯文本字符串，或包含文本、图片、视频的多模态内容数组。

thinkingobject

配置扩展思考模式。type 控制是否启用推理；reasoning_effort 控制推理预算。

reasoning_effortstring

推理强度预算。与 thinking.type 配合使用；thinking.type 为 disabled 时可降低延迟。

lowmediumhigh

max_tokensinteger

生成的最大 token 数。典型请求建议低于 128K；上限 512K。

Min: 1 Max: 524288

streamboolean

若为 true，则以 Server-Sent Events 流式返回部分消息增量。

默认值"false"

输出参数

API 返回兼容 OpenAI Chat Completions 的响应格式。

总计: 6

idstring

补全的唯一标识符。

objectstring

对象类型，固定为 chat.completion。

createdinteger

补全创建时的 Unix 时间戳。

modelstring

用于补全的模型 ID。

choicesarray[object]

补全选项列表。

usageobject

Token 使用统计。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

# MiniMax-M3

> MiniMax M3 是 MiniMax 最新 M 系列多模态基础模型，面向 Agent 推理、工具调用、编码与长上下文任务。

## 概述

通过 iCreat OpenAI 兼容 Chat Completions API 进行对话补全，支持流式与非流式、扩展思考模式。

## API 信息

- **Base URL**：`https://api.icreat.ai/llm/openai/v1`
- **Endpoint (POST)**：`/chat/completions`
- **Model ID**：`MiniMax-M3`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

单次 POST；`stream: false` 返回完整 JSON，`stream: true` 以 SSE 流式返回。

### 输入要点

- `model`（必填）：iCreat model_code `MiniMax-M3`
- `messages`（必填）：对话消息列表
- 常见可选：`max_tokens`（最大输出 token）、`stream`（流式开关）、`thinking`（扩展思考模式）、`reasoning_effort`（推理强度）
- `image_url`（可选）：当 `type` 为 `image_url` 时的图片 URL 对象。
- `url`（必填）：图片的 HTTPS URL。
- `video_url`（可选）：当 `type` 为 `video_url` 时的视频 URL 对象。
- `url`（必填）：视频的 HTTPS URL。

### 输出要点

- 从 `choices[0].message.content` 读取回复

## 注意事项

- `model` 必须使用 iCreat model_code
- 其余字段与 OpenAI Chat Completions 协议一致