MiniMax M3.1 Flash

Nutzen Sie MiniMax M3.1 Flash mit Chat Completions, Messages oder Responses. Offizielle Parameter, multimodale Eingaben, Reasoning, Tool-Verlauf und Token-Abrechnung.

Verwenden Sie exakt die Modell-ID MiniMax-M3.1-Flash. Auf der Modellseite finden Sie den Playground und aktuelle Preise. Die OpenAPI-Spezifikation definiert verschachtelte Anfrage- und Antwortfelder.

Schnellstart

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"
  }'

Dieses Beispiel legt ein Ausgabelimit fest; es ist nicht der Standardwert des Modells. Bewahren Sie Schlüssel auf Ihrem Server auf. Der Playground nutzt Ihr angemeldetes Konto, sodass Sie keinen API-Schlüssel einfügen müssen.

Formate und Authentifizierung

Format	Endpunkt	Pflichtfelder	Felder auf oberster Ebene insgesamt
Chat Completions	`POST /v1/chat/completions`	`model`, `messages`	13
Messages	`POST /v1/messages`	`model`, `messages`	12
Responses	`POST /v1/responses`	`model`, `input`	13

Senden Sie Content-Type: application/json und Authorization: Bearer $SEEDROUTER_API_KEY. Messages akzeptiert auch x-api-key; SDK-Clients können anthropic-version: 2023-06-01 mitsenden. Die Formate behalten ihre nativen Anfrageinhalte und Antwortstrukturen bei.

Parameter

Alle Felder außer den oben genannten Pflichtfeldern sind optional. Ein ausgelassenes Feld unterscheidet sich von einem expliziten null: Ein Feld akzeptiert null nur, wenn die OpenAPI-Spezifikation dies festlegt. Nicht unterstützte Felder auf oberster Ebene werden verworfen; ungültige Werte unterstützter Felder führen zu einem Fehler.

Chat Completions

Feld	Typ	Regel
`model`	Zeichenfolge	Exakt `MiniMax-M3.1-Flash`
`messages`	Array	Native Gesprächsnachrichten; Reasoning und Tool-Verlauf beibehalten
`thinking`	Objekt	`type` darf nur `adaptive` sein
`reasoning_effort`	Zeichenfolge	`low`, `medium`, `high`, `xhigh`, `max`; Standard: `max`
`reasoning_split`	Boolescher Wert	Nur `true`
`stream`	Boolescher Wert	Standard: `false`
`stream_options`	Objekt	`include_usage` steuert die Anzeige der Nutzungsdaten beim Streaming
`max_completion_tokens`	Ganzzahl	1–524288; einschließlich Reasoning- und Antwort-Token
`max_tokens`	Ganzzahl	Älteres Ausgabelimit, 1–524288; bevorzugt `max_completion_tokens` verwenden
`temperature`	Zahl	Akzeptiert, aber ignoriert; das Modell verwendet 1
`top_p`	Zahl	Größer als 0 und höchstens 1; wird ignoriert, das Modell verwendet 0.95
`tools`	Array	Funktionsdefinitionen: `type`, `function.name`, `function.parameters`, optionale Beschreibung
`n`	Ganzzahl	Nur 1

Messages

Feld	Typ	Regel
`model`	Zeichenfolge	Exakt `MiniMax-M3.1-Flash`
`messages`	Array	Native user/assistant-Nachrichten und Inhaltsblöcke
`system`	Zeichenfolge oder Array	Systemanweisungen oder Textblöcke
`stream`	Boolescher Wert	Standard: `false`
`max_tokens`	Ganzzahl	1–524288 einschließlich Reasoning; im API-Schema des Modells optional
`temperature`	Zahl	Akzeptiert, aber ignoriert; das Modell verwendet 1
`top_p`	Zahl	Größer als 0 und höchstens 1; das Modell verwendet 0.95
`tools`	Array	Native Funktionsdefinitionen mit `input_schema`
`tool_choice`	Objekt	Nur `{"type":"auto"}`
`thinking`	Objekt	Nur `{"type":"adaptive"}`
`output_config`	Objekt	`effort`: `low`, `medium`, `high`, `xhigh`, `max`; Standard: `max`
`metadata`	Objekt	Optionale native Metadaten

Responses

Feld	Typ	Regel
`model`	Zeichenfolge	Exakt `MiniMax-M3.1-Flash`
`input`	Zeichenfolge oder Array	Text oder native Nachrichten-, Funktionsaufruf-, Funktionsergebnis- und Reasoning-Elemente
`instructions`	Zeichenfolge	Systemanweisungen
`max_output_tokens`	Ganzzahl	1–524288 einschließlich Reasoning
`temperature`	Zahl	Akzeptiert, aber ignoriert; das Modell verwendet 1
`top_p`	Zahl	Größer als 0 und höchstens 1; das Modell verwendet 0.95
`stream`	Boolescher Wert	Standard: `false`
`tools`	Array	Native Funktionsdefinitionen
`tool_choice`	Zeichenfolge	Nur `auto`
`metadata`	Objekt	Werte müssen Zeichenfolgen sein
`prompt_cache_key`	Zeichenfolge	Optionaler Schlüssel zur Cache-Gruppierung
`text`	Objekt	Nur `{"format":{"type":"text"}}`
`reasoning`	Objekt	`effort`: die fünf Stufen oben; Standard: `max`

Der Playground gibt model fest vor und bietet alle übrigen Felder an: 12 Bedienelemente für Chat, 11 für Messages und 12 für Responses. Verschachtelte Objekte und vollständige Gesprächsverläufe werden über JSON-Felder eingegeben. Ungültige Werte unterstützter Felder verhindern das Absenden im Browser.

Reasoning und Limits

Das dokumentierte Kontextfenster umfasst 1.000.000 Token. Das Ausgabelimit beträgt 524.288 Token einschließlich Reasoning. MiniMax empfiehlt für anspruchsvolle Aufgaben 131.072 Ausgabe-Token, legt diesen Wert aber nicht als Standard fest.

Thinking ist immer aktiviert. disabled, none und minimal werden als Thinking-Einstellungen für dieses Modell nicht unterstützt. Ein knappes Ausgabebudget kann bereits aufgebraucht sein, bevor Antworttext erscheint. service_tier, Audioeingaben und strukturierte JSON-Ausgaben gehören nicht zu den unterstützten Funktionen dieser Schnittstellenspezifikation.

Der gesamte Anfrageinhalt darf 64 MB nicht überschreiten. Der Modelldienst prüft die genaue Kontextnutzung und die Inhalte entfernter Medien.

Bilder und Videos

Eingabe	Unterstützte Formate	Limit
Bild	JPEG, PNG, GIF, WebP	10 MB pro Bild
Video per URL oder inline	MP4, AVI, MOV, MKV	50 MB pro Video
Gesamte Anfrage	JSON-Inhalt	64 MB

Chat verwendet die Inhaltsblöcke image_url: {"url":"..."} und video_url: {"url":"..."}. Messages verwendet Bild-/Videoblöcke mit einem source-Objekt: {"type":"url","url":"..."} oder {"type":"base64","media_type":"...","data":"..."}. Responses verwendet input_image oder input_video; deren URL-Wert kann eine Zeichenfolge oder ein unterstütztes Optionsobjekt sein.

detail akzeptiert low, default und high; der Standardwert ist default. Für Videos liegt fps zwischen 0.2 und 5, der Standardwert ist 1. Das optionale Feld max_long_side_pixel muss eine positive Ganzzahl sein, sofern es im verschachtelten Schema angeboten wird.

{
  "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
}

Ersetzen Sie die Beispiel-URL durch Ihre eigene zugängliche Datei. Inline-Eingaben verwenden den passenden base64-MIME-Typ; MOV verwendet video/mov. Vorhandene mm_file://-Videoreferenzen werden durchgereicht, dieser Dienst bietet jedoch keine Files-Upload-API. Das Konto, das die Anfrage verarbeitet, muss weiterhin auf die Referenz zugreifen können.

Tools und Gesprächsverlauf

Funktionstools beschreiben Aktionen, die Ihre Anwendung ausführen kann. Ein Tool-Aufruf belegt nicht, dass eine externe Aktion ausgeführt wurde: Prüfen Sie Namen und Argumente, führen Sie die Aktion in Ihrer Anwendung aus und geben Sie anschließend das Ergebnis mit der passenden Aufruf-ID zurück.

Beim Fortsetzen von Chat bleibt die vollständige assistant-Nachricht erhalten, einschließlich reasoning_content und tool_calls; Tool-Nachrichten benötigen tool_call_id. Bei Messages bleiben Thinking-Blöcke, Signaturen sowie tool_use- und tool_result-Blöcke erhalten. Bei Responses fügen Sie vor der nächsten Nutzereingabe alle zurückgegebenen Ausgabeelemente an.

Fassen Sie diese Verläufe nicht zu reinem Antworttext zusammen. Beliebige Funktionsparameterschemas und zurückgereichte Reasoning-Felder bleiben erhalten. Die offizielle Chat-Referenz definiert für dieses Modell keinen Parameter tool_choice.

Streaming und Antwortfelder

Setzen Sie stream: true, um Server-Sent Events zu erhalten. Chat sendet choices[].delta und endet mit [DONE]; mit stream_options: {"include_usage":true} erhalten Sie Nutzungsdaten. Messages sendet benannte Ereignisse wie message_start, Aktualisierungen von Inhaltsblöcken und message_stop. Responses sendet Ereignisse wie response.output_text.delta und response.completed.

Ohne Streaming gibt Chat choices[].message, finish_reason und usage zurück. Messages liefert Inhaltsblöcke, stop_reason und Nutzungsdaten. Responses liefert output-Elemente, Status und Nutzungsdaten. Bewahren Sie die vollständige Antwort auf, wenn Ihre Anwendung mehr als den angezeigten Antworttext benötigt.

Nutzung und aktuelle Preise

Die aktuelle Preistabelle zeigt beide Eingabestufen. Bei insgesamt bis zu 512.000 Eingabe-Token gilt die erste Stufe, bei mehr als 512.000 die zweite. Die gewählte Stufe bestimmt den Preis der gesamten Anfrage, einschließlich Ausgabe und Cache.

Format	Gesamte Eingabe	Ausgabe
Chat	`prompt_tokens` enthält gecachte Eingabe	`completion_tokens` enthält Reasoning
Messages	`input_tokens`, `cache_read_input_tokens` und `cache_creation_input_tokens` addieren	`output_tokens` enthält Reasoning
Responses	`input_tokens` enthält gecachte Eingabe	`output_tokens` enthält Reasoning

Token für Cache-Lese- und Cache-Schreibvorgänge werden nicht zusätzlich als gewöhnliche Eingabe berechnet. Das automatische Caching prüft geeignete wiederholte Präfixe mit mindestens 512 Token; Cache-Treffer sind nicht garantiert. Eine explizite Cache-Markierung ist nicht erforderlich.

Antworten enthalten Token-Zahlen, keine Geldbeträge. Die endgültigen Kosten sehen Sie in den Nutzungsaufzeichnungen Ihres Kontos. Fehlgeschlagene Anfragen werden nicht berechnet.

Fehler

Prüfen Sie bei Fehlern das ungültige Feld und die öffentliche Fehlerreferenz. Dieselbe Modell-ID unterstützt die drei oben genannten Text-Endpunkte; sie ist nicht für einen Embeddings- oder Gemini-Endpunkt vorgesehen.