MiniMax-M3 - OpenAI 兼容接口
- 使用 OpenAI Chat Completions 协议调用 MiniMax-M3 模型
- 多轮对话:支持单轮或多轮上下文对话
- 系统提示词:通过
role=system消息自定义 AI 的角色和行为 - 多模态输入:
content支持文本 + 图像 / 视频混排 - 思考模式:通过
thinking.type控制;思考内容通过reasoning_content返回 - 流式输出:支持 SSE 流式返回
- 工具调用:支持 Function Calling
授權
##所有接口均需要使用 Bearer Token 进行认证## **获取 API Key**: 访问 [API Key 管理页面](https://starmagic.ai/app/api-keys) 获取您的 API Key **使用时在请求头中添加**: ``` Authorization: Bearer YOUR_API_KEY ```
Authorization: Bearer YOUR_API_KEY請求體
application/json对话模型名称
"MiniMax-M3"对话消息列表,支持多轮对话 不同角色的消息具有不同的字段结构,请选择对应角色查看
[
null
]控制深度思考 **说明**: - **默认 `adaptive`**:模型根据问题难度自适应决定是否进行深度思考 - 默认情况下思考内容会内联在回复 `content` 中(以 `<think>...</think>` 包裹);如需拆分到独立字段,请配合 `reasoning_split`
{
"type": "adaptive"
}是否将思考内容拆分到独立字段 - `false`(默认):思考内容内联在 `content` 中,以 `<think>...</think>` 包裹 - `true`:思考内容拆分到 `choices[].message.reasoning_content` 与 `reasoning_details`
true采样温度,控制输出的随机性 **说明**: - 较低值(如 0.2):更确定、更聚焦的输出 - 较高值(如 1.5):更随机、更有创意的输出 - 取值范围 `[0, 2]`,默认 1
1核采样(Nucleus Sampling)参数 **说明**: - 控制从累积概率前多少的 token 中采样 - 例如 0.95 表示从累积概率达到 95% 的 token 中选择 - 取值范围 `[0, 1]`,MiniMax-M3 默认 0.95 **建议**:不要同时调整 temperature 和 top_p
0.95指定生成内容长度的上限(Token 数) **说明**: - MiniMax-M3 推荐 **131,072**(128K),上限 **524,288**(512K) - 思考产生的 token 也计入该上限 - 如果生成因 `length` 原因中断,请尝试调高此值
131072是否以流式方式返回响应 - `true`:流式返回,通过 SSE(Server-Sent Events)逐块实时返回内容 - `false`:等待完整响应后一次性返回(默认)
false流式响应选项 仅在 `stream=true` 时有效
{
"include_usage": true
}工具定义列表,用于 Function Calling 每个工具需要定义名称、描述和参数 schema
[
{
"type": "function",
"function": {
"name": "string",
"description": "string",
"parameters": {}
}
}
]旧版生成长度限制参数 **说明**:已弃用,请改用 `max_completion_tokens`
0回應
application/json回應體
对话完成的唯一标识符
"0668a381bdc3c0ded310e27c9a46d16e7"实际使用的模型名称
"MiniMax-M3"响应类型
"chat.completion"创建时间戳(Unix 秒)
1777026807对话生成的选择列表
[
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是 MiniMax-M3,可以帮你完成对话、写作、推理、代码等多种任务。",
"reasoning_content": "让我分析一下这个问题...",
"reasoning_details": [
{
"type": null,
"id": null,
"format": null,
"index": null,
"text": null
}
],
"name": "string",
"audio_content": "string",
"tool_calls": [
{
"id": null,
"type": null,
"function": null,
"index": null
}
]
},
"finish_reason": "stop"
}
]Token 使用统计信息
{
"total_tokens": 1604,
"total_characters": 0,
"prompt_tokens": 1365,
"completion_tokens": 239,
"prompt_tokens_details": {
"cached_tokens": 114
}
}输入内容是否命中敏感词。若输入严重违规,接口会返回内容违规错误,回复内容为空
true输入命中敏感词类型(`input_sensitive` 为 true 时返回):1 严重违规;2 色情;3 广告;4 违禁;5 谩骂;6 暴恐;7 其他
0输出内容是否命中敏感词
true输出命中敏感词类型
0状态码和错误详情
{
"status_code": 0,
"status_msg": "string"
}
