GET

/v1/schemas/minimax-cn/chat/anthropic/v1/messages

Accept:

kind inputactivity chathash eaef582e…extracted Nov 8, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `40a5b441896c807cd4b42ad53adceea08d4a05335a8d4056ef51dc342232dca4` { "fetchedAt": 1794114637, "extractorVersion": "2", "verifiedAt": null }

Request body

13 properties · 2 required · 6 $defs

property	type	description	constraints
model*	enum	模型 ID。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 是多模态模型，原生支持文本、图片和视频输入，并兼容工具调用与 thinking 内容块；`MiniMax-M3.1-Flash` 还会强制开启 thinking，并支持通过 `output_config.effort` 调节思考深度。	MiniMax-M3.1-Flash \| MiniMax-M3
messages*	Message[]	对话历史。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持文本、图片、视频、工具调用、工具结果和 thinking 内容块。
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"
system	string \| object[]	设置模型角色与行为。
stream	boolean	是否使用流式传输，默认为 `false`。设置为 `true` 后，响应将分批返回	default: false
max_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	Tool[]	Anthropic 兼容工具调用的工具定义。
tool_choice	ToolChoice	工具选择策略。仅支持 `auto`，由模型自动判断是否调用工具。
thinking	object	控制 thinking 行为。默认值随模型不同，因此未在 schema 层声明统一默认值。 - `MiniMax-M3.1-Flash`：强制开启 thinking。若传入 `type` 只能为 `adaptive`；传入 `disabled` 会返回 HTTP 400。如需调节思考深度，请使用 `output_config.effort`。 - `MiniMax-M3`：省略 `thinking` 时默认关闭；传入 `adaptive` 可开启并返回 thinking 块。
output_config	object	输出配置。通过 `effort` 调节 `MiniMax-M3.1-Flash` 的思考深度。
metadata	object	请求元信息。建议对 to-C 业务传入 user_id，便于按终端用户聚合限流和计费分析。

Types

6 $defs

CacheControlobject

提示词缓存标记。MiniMax-M3 和 MiniMax-M3.1-Flash 不支持该参数。

type*

enum

提示词缓存标记。

ephemeral

MediaSourceobject

图片或视频内容块的媒体来源。

type*	enum	媒体来源类型。	base64 \| url
media_type	string	base64 输入时必填，例如 image/png 或 video/mp4。
data	string	base64 编码后的媒体字节。
url	string	公网 URL。视频还可使用 Files API 引用 `mm_file://{file_id}`，`file_id` 需先通过[文件上传](/api-reference/file-management-upload)接口上传视频后获取。
detail	enum	理解精细度，默认 default。	low \| default \| high · default: "default"
fps	number	视频抽帧频率，默认 1，范围 [0.2, 5]。 - 取值越高：对画面变化越敏感，token 花费高、速度慢。 - 取值越低：token 花费少、速度快，但对画面变化迟钝。	0.2 ≤ n ≤ 5 · default: 1
max_long_side_pixel	integer	图片或视频帧最长边像素约束。	n ≥ 1

Messageobject

role*	enum	消息发送方角色。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 使用 user / assistant 交替消息。	user \| assistant \| user_system \| group \| sample_message_user \| sample_message_ai
content*	string \| RequestContentBlock[]	消息内容。`MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持文本、图片、视频、工具调用、工具结果和 thinking 内容块。

RequestContentBlockobject

请求消息中可用的内容块。text 与工具相关块所有模型均支持；image 与 video 块仅 `MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持。thinking 仅在多轮对话中将上一轮 assistant 输出原样回带时使用。

type*	enum	内容块类型： - text：文本内容 - image：图片输入，仅 `MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持 - video：视频输入，仅 `MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持 - tool_use：回带上一轮的 assistant 工具调用 - tool_result：工具执行结果 - thinking：回带上一轮的 assistant 思考内容 - mid_conv_system：对话中途插入的系统指令	text \| image \| video \| tool_use \| tool_result \| thinking · +1 more
text	string	文本内容，type=text 时使用。
source	MediaSource	图片或视频来源，type=image 或 type=video 时使用，仅 `MiniMax-M3.1-Flash` 和 `MiniMax-M3` 支持。
id	string	回带 type=tool_use 时使用的工具调用 ID。
name	string	回带 type=tool_use 时使用的工具名称。
input	object	回带 type=tool_use 时使用的工具输入。
tool_use_id	string	对应 tool_use 块的 ID，type=tool_result 时使用。
content	string \| RequestContentBlock[]	工具执行结果，可为字符串或 text/image 内容块数组。
thinking	string	回带的 assistant 思考过程内容，type=thinking 时使用。
signature	string	回带的 thinking 内容签名，多轮续写时需要原样回带。
cache_control	CacheControl	提示词缓存标记。MiniMax-M3 和 MiniMax-M3.1-Flash 不支持该参数。

Toolobject

Anthropic 兼容工具调用的工具定义。

name*	string	工具名称。
description	string	工具描述。
input_schema*	object	工具输入参数 JSON Schema。
cache_control	CacheControl	提示词缓存标记。MiniMax-M3 和 MiniMax-M3.1-Flash 不支持该参数。

ToolChoiceobject

工具选择策略。仅支持 `auto`，由模型自动判断是否调用工具。

type*

enum

工具选择类型。

auto

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"minimax-cn","endpointId":"anthropic/v1/messages","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}