GET
/v1/schemas/minimax-cn/chat/v1%2Fchat%2Fcompletions
Accept:
Request body
13 properties · 2 required · 3 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | enum | 模型 ID。支持 `MiniMax-M3.1-Flash` 和 `MiniMax-M3`。 | MiniMax-M3.1-Flash | MiniMax-M3 |
| messages* | Message[] | 包含对话历史的消息列表。支持文本、图片、视频和工具调用。 | |
| service_tier | enum | 请求准入服务层级。支持的取值为 `standard` 和 `priority`。省略时默认使用 `standard`。`priority` 的[价格](https://platform.minimax.cn/docs/pricing/overview#models/text)为 `standard` 的 1.5 倍,并会确保请求获得优先准入,使其排在其他请求之前处理,从而带来更快响应并减少失败。`MiniMax-M3.1-Flash` 不支持该字段。 | standard | priority · default: "standard" |
| thinking | object | 控制 thinking 行为。`adaptive` 这个默认值对所有模型都生效,差异只在 `disabled` 的效果上。 - `MiniMax-M3.1-Flash`:强制开启 thinking。传入 `disabled` 会返回 HTTP 400。如需调节思考深度,请使用 `reasoning_effort`。 - `MiniMax-M3`:默认开启 adaptive thinking;传入 `disabled` 会跳过 thinking 直接回答。 | |
| reasoning_effort | enum | 调节思考深度。仅 `MiniMax-M3.1-Flash` 支持真正的思考深度调节,其他模型会忽略该字段。省略时,该模型的默认思考深度为 `max`。由于 `MiniMax-M3.1-Flash` 强制开启 thinking,不接受 `none`,传入会返回 HTTP 400。 | low | medium | high | xhigh | max |
| reasoning_split | boolean | 输出格式开关。为 `true` 时将 thinking 内容拆分到 `reasoning_content` 字段;为 `false` 时 thinking 以 `<think>` 标签保留在 `content` 字段内。`MiniMax-M3.1-Flash` 不支持将该参数设为 `false`。该参数不会开启或关闭 thinking。 | |
| stream | boolean | 是否使用流式传输,默认为 `false`。设置为 `true` 后,响应将分批返回。 | default: false |
| stream_options | object | 流式响应选项。 | |
| max_completion_tokens | integer | 指定生成内容长度的上限(Token 数)。MiniMax-M3.1-Flash 和 MiniMax-M3 推荐值为 131072(128K),上限为 524288(512K)。如果生成因 `length` 原因中断,请尝试调高此值。 | n ≥ 1 · format: int64 |
| temperature | number | 暂不支持指定,传入的值不会生效。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 固定使用 1。 | format: double · default: 1 |
| top_p | number | 暂不支持指定,传入的值不会生效。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 固定使用 0.95。若传入,取值需在 (0, 1] 范围内。 | 0 ≤ n ≤ 1 · format: double · default: 0.95 |
| tools | object[] | 工具定义列表,当前支持 function 工具。 | |
| max_tokens | integer | 旧版生成长度限制参数。已弃用,请改用 `max_completion_tokens`。 | n ≥ 1 · format: int64 · deprecated |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"minimax-cn","endpointId":"v1/chat/completions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}