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 參考文件
• 延續函式呼叫
• 自動提示詞快取