跳转到主要内容
POST

授权

Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看

请求头

Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型,请设置为 application/json,确保请求数据的格式为 JSON

可用选项:
application/json

请求体

application/json
model
string
必填

调用的模型名称,如 MiniMax-M3.1-Flash

示例:

"MiniMax-M3.1-Flash"

input
必填

对话内容,支持简单文本或完整对话历史数组

service_tier
enum<string>
默认值:standard

请求准入服务层级。支持的取值为 standard 和 priority。省略时默认使用 standard。priority 的价格为 standard 的 1.5 倍,并会确保请求获得优先准入,使其排在其他请求之前处理,从而带来更快响应并减少失败。MiniMax-M3.1-Flash 不支持该字段。

可用选项:
standard,
priority
instructions
string

系统指令

max_output_tokens
integer

最大输出 token 数。推理 token 也计入此上限,设置过小会导致 status 为 incomplete 且 output 中没有 message 项。

temperature
number<float>
默认值:1

暂不支持指定,传入的值不会生效。MiniMax-M3.1-Flash 和 MiniMax-M3 固定使用 1。

top_p
number<float>
默认值:0.95

暂不支持指定,传入的值不会生效。MiniMax-M3.1-Flash 和 MiniMax-M3 固定使用 0.95。若传入,取值需在 (0, 1] 范围内。

必填范围: 0 < x <= 1
stream
boolean
默认值:false

设置为 true 启用 SSE 流式响应

tools
object[]

工具列表

tool_choice
enum<string>

工具选择策略:auto 表示由模型自动判断是否调用工具

可用选项:
auto
metadata
object

请求元数据,key-value 均为字符串

prompt_cache_key
string

Prompt 缓存路由标识

text
object

输出格式控制

reasoning
object

推理控制。默认值随模型不同,因此未在 schema 层声明统一默认值。

  • MiniMax-M3.1-Flash:推理始终开启,省略 reasoning 时也会推理。effort 可取 low、medium、high、xhigh 或 max,并且确实会调节推理深度;省略时默认使用 max 档位。传入 effort: "none" 会返回 HTTP 400。
  • MiniMax-M3:默认关闭推理;将 effort 设为非 none 值可开启推理,但不会调节推理深度。

响应

成功响应

id
string

响应 ID

示例:

"abc123"

object
enum<string>

对象类型,固定为 response

可用选项:
response
created_at
integer

响应创建时间(Unix 秒)

model
string

实际处理请求的模型名称

示例:

"MiniMax-M3.1-Flash"

status
enum<string>

响应状态

可用选项:
completed,
incomplete,
failed
output
(Message · object | Reasoning · object | Function Call · object)[]

模型输出列表

output_text
string | null

便捷字段:所有文本输出拼接后的结果

usage
object
error
object | null

错误信息,仅在 status=failed 时返回

incomplete_details
object | null

未完成原因,仅在 status=incomplete 时返回

parallel_tool_calls
boolean

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 true。

store
boolean

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 false。

truncation
enum<string>

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 disabled。

可用选项:
disabled
previous_response_id
string | null

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 null。

conversation
object | null

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 null。

service_tier
string | null

本次请求实际生效的服务层级,取值为 standard 或 priority。MiniMax-M3.1-Flash 不支持该字段,响应中返回 null。

safety_identifier
string | null

请求中暂不支持该参数,传入后将被忽略,响应中固定返回 null。