MiniMax M3.1 Flash

模型 ID 必须为 MiniMax-M3.1-Flash。模型页面提供 Playground 和实时价格。OpenAPI 规范定义了请求与响应中的嵌套字段。

快速开始

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

示例中设置的输出上限不是模型默认值。请将密钥保存在服务器上。Playground 使用当前登录的账户，无需粘贴 API Key。

请求格式与身份验证

请求须携带 Content-Type: application/json 和 Authorization: Bearer $SEEDROUTER_API_KEY。Messages 也接受 x-api-key；SDK 客户端可携带 anthropic-version: 2023-06-01。各格式均保留其原生请求体和响应结构。

参数

除上表列出的必填字段外，其余字段均为可选。省略字段与显式传入 null 不同：只有 OpenAPI 明确声明允许时，字段才接受 null。不支持的顶层字段会被丢弃；支持的字段若取值不合法，则返回错误。

Chat Completions

Messages

Responses

Playground 固定 model，并提供其余所有字段的控件：Chat 12 个、Messages 11 个、Responses 12 个。嵌套对象和完整对话历史通过 JSON 字段输入。支持的字段若取值不合法，浏览器会阻止提交。

推理与使用限制

文档规定的上下文窗口为 1,000,000 token。输出上限为 524,288 token，包含推理。MiniMax 建议为复杂任务设置 131,072 token 的输出额度，但未将该值指定为默认值。

思考始终开启。该模型的思考设置不支持 disabled、none 和 minimal。输出额度过小时，可能在生成回答文本前就已耗尽。此参数契约不支持 service_tier、音频输入和结构化 JSON 输出。

请求体总大小不得超过 64 MB。模型服务会校验实际上下文用量和远程媒体内容。

图片与视频

Chat 使用 image_url: {"url":"..."} 和 video_url: {"url":"..."} 内容块。Messages 使用包含 source 对象的图片/视频块：{"type":"url","url":"..."} 或 {"type":"base64","media_type":"...","data":"..."}。Responses 使用 input_image 或 input_video，其中的 URL 值可以是字符串，也可以是受支持的选项对象。

detail 接受 low、default、high，默认为 default。视频 fps 的范围为 0.2 至 5，默认为 1。嵌套 schema 中提供的可选字段 max_long_side_pixel 必须为正整数。

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

请将示例 URL 替换为你自己的可访问文件地址。内联输入须使用相应的 base64 MIME 类型；MOV 使用 video/mov。已有的 mm_file:// 视频引用会原样传递，但本服务不提供 Files 上传 API。处理请求的账户仍需有权访问该引用。

工具调用与对话历史

函数工具描述应用可以执行的操作。收到工具调用不代表外部操作已经执行：应先检查函数名和参数，在应用中执行操作，再携带匹配的调用 ID 返回结果。

继续 Chat 对话时，须保留完整的 assistant 消息，包括 reasoning_content 和 tool_calls；工具消息必须包含 tool_call_id。继续 Messages 对话时，须保留思考块、签名、tool_use 和 tool_result 块。继续 Responses 对话时，须先追加返回的所有输出条目，再追加下一条用户输入。

不要将这些历史记录合并成回答文本。任意函数参数 schema 和回传的推理字段都会保留。Chat 官方参考文档未为该模型定义 tool_choice 参数。

流式输出与响应字段

设置 stream: true 即可接收服务器发送事件。Chat 发送 choices[].delta，并以 [DONE] 结束；请求中设置 stream_options: {"include_usage":true} 可接收用量信息。Messages 发送具名事件，例如 message_start、内容块更新和 message_stop。Responses 发送的事件包括 response.output_text.delta 和 response.completed。

非流式 Chat 返回 choices[].message、finish_reason 和 usage。Messages 返回内容块、stop_reason 和用量信息。Responses 返回 output 条目、状态和用量信息。应用若需要显示答案以外的信息，应保留完整响应。

用量与当前价格

实时价格表列出两档输入用量对应的价格。总输入不超过 512,000 token 时使用第一档，超过 512,000 token 时使用第二档。选定的档位适用于整个请求，包括输出和缓存。

缓存读取和缓存写入 token 不会再按普通输入重复收费。自动缓存会检查至少 512 token 且符合条件的重复前缀，但不保证命中。无需显式设置缓存标记。

响应中提供 token 数，不提供金额。账户使用记录中显示最终费用。失败的请求不收费。

错误处理

发生错误时，请检查不合法的字段，并查阅公开错误参考文档。同一模型 ID 支持上述三个文本接口，不适用于 embeddings 或 Gemini 接口。

官方参考资料

• MiniMax 模型调用
• Chat Completions 参考文档
• Messages 参考文档
• Responses 参考文档
• 函数调用续接
• 自动提示词缓存