MiniMax M3 API Quick Start mit Novita AI

MiniMax M3 ist über Novita AI mit der Modell-ID minimax/minimax-m3, einer OpenAI-kompatiblen Basis-URL, einem Kontextfenster von 1.000.000 Token und gestaffelten Preisen für längere Prompts verfügbar. Dieser Quick Start hält die Einrichtung praktisch: Kopieren Sie die Modell-ID, setzen Sie Ihren API-Schlüssel, führen Sie eine kleine Anfrage aus und skalieren Sie dann auf längere Prompts, sobald die Grundlagen funktionieren.

Wann Sie diesen Quick Start verwenden sollten

Verwenden Sie diesen Quick Start, wenn Sie MiniMax M3 über einen serverlosen API-Pfad testen möchten, anstatt sich um die reine Modell-Hosting-Umgebung zu kümmern. Er richtet sich an Entwickler, die bereits einen Prompt oder Workload im Kopf haben und den Endpunkt, die Modell-ID, Token-Limits und Preise benötigen, bevor sie einen kleinen Proof of Concept schreiben.

MiniMax M3 ist eine gute Wahl, wenn Ihre Anfrage ein großes Kontextbudget, strukturierte Ausgaben, aufgabenorientierte Aufgaben oder Programmierunterstützung über lange Eingaben erfordert. Auf Novita AI listet die aktuelle Modellseite Text, Bild und Video als akzeptierte Eingabemodalitäten, Text als Ausgabemodalität und Unterstützung für serverlosen Zugriff, Funktionsaufrufe, strukturierte Ausgaben, Reasoning und Anthropic-API-Kompatibilität.

Dies ist kein tiefer Benchmark-Einblick oder eine Ankündigung. Das Ziel ist einfacher: eine saubere Anfrage stellen und dann entscheiden, ob MiniMax M3 zu Ihrer Anwendung passt.

Schritt 1: Holen Sie Ihren Novita-API-Schlüssel

Erstellen oder wählen Sie ein Novita AI-Konto, öffnen Sie Ihre API-Schlüsseleinstellungen und generieren Sie einen Schlüssel für die serverseitige Nutzung. Halten Sie den Schlüssel aus clientseitigem Code, Frontend-Bundles, öffentlichen Repositories und Notizbüchern fern, die außerhalb Ihres Teams geteilt werden könnten.

Setzen Sie den Schlüssel als Umgebungsvariable, bevor Sie die Beispiele ausführen:

export NOVITA_API_KEY="your_api_key_here"

Wenn Sie in einer Teamumgebung testen, verwenden Sie einen eingeschränkten Projektschlüssel oder einen temporären Schlüssel, falls Ihr Konto dies unterstützt. Rotieren Sie den Schlüssel nach öffentlichen Demos, geteilten Experimenten oder versehentlicher Offenlegung.

Schritt 2: Bestätigen Sie Modell-ID und Endpunkt

Bevor Sie Code schreiben, halten Sie die Verbindungsdetails für MiniMax M3 an einem Ort bereit:

Feld	Wert
Modell-ID	minimax/minimax-m3
Basis-URL	https://api.novita.ai/openai
Chat-Completions-URL	https://api.novita.ai/openai/v1/chat/completions
Kontextfenster	1.000.000 Token
Maximale Ausgabe	131.072 Token
Eingaben	Text, Bild, Video
Ausgabe	Text
Serverlose Unterstützung	Unterstützt
Funktionsaufruf	Unterstützt
Strukturierte Ausgabe	Unterstützt
Reasoning	Unterstützt
Anthropic-API-Kompatibilität	Unterstützt

Überprüfen Sie die MiniMax M3-Modelldokumentation, bevor Sie Ihre Lösung ausliefern, da Verfügbarkeit, Preise und Limits sich ändern können.

Schritt 3: Senden Sie Ihre erste Anfrage

Beginnen Sie mit einer kurzen textbasierten Chat-Anfrage. Es ist viel einfacher, Authentifizierung, Routing und Antwort-Parsing zu debuggen, bevor Sie einen großen Prompt hinzufügen.

Fragen Sie bei der ersten Anfrage nach einer deterministischen, leicht überprüfbaren Ausgabe. Zum Beispiel: Fassen Sie die wichtigsten Implementierungsrisiken in einem Code-Review-Prozess mit langem Kontext zusammen.

Halten Sie max_tokens für den ersten Aufruf bescheiden. MiniMax M3 unterstützt viel längere Ausgaben, aber die erste Aufgabe ist, die Integration zu bestätigen.

Schritt 4: Lesen Sie die Antwort

Eine OpenAI-kompatible Chat-Completion-Antwort gibt normalerweise die Assistentenantwort unter choices[0].message.content zurück.

Protokollieren Sie auch die Anfrage-ID oder die Metadaten der Antwort, die Ihre Laufzeitumgebung bereitstellt. Diese Details sind nützlich, wenn eine Anfrage fehlschlägt oder langsam läuft. Für die Kostenverfolgung notieren Sie die Prompt-Größe, die Ausgabegröße, die Cache-Lese-Nutzung (falls Ihr Workload zwischengespeicherten Kontext verwendet) und ob die Anfrage in die Preisklasse für langen Kontext fiel.

Behandeln Sie die erste Ausgabe nicht als Beweis dafür, dass Ihr Prompt bereit für Benutzer ist. Sobald die Integration funktioniert, testen Sie Prompts, die Ihrem tatsächlichen Workload ähneln: lange Codebasen, dateiübergreifende Anweisungen, Tool-Schemas, strukturierte JSON-Ausgaben oder multimodale Eingaben, falls Ihre Anwendung diese benötigt.

Schritt 5: Überprüfen Sie Preise, Limits und häufige Fehler

MiniMax M3 verwendet auf Novita AI gestaffelte Preise. Der Preis ändert sich, sobald der Prompt in die Kategorie für langen Kontext fällt:

Prompt-Größenbereich	Eingabe	Ausgabe	Cache-Lesen
Weniger als 524.288 Token	0,30 $ pro 1 Mio. Token	1,20 $ pro 1 Mio. Token	0,06 $ pro 1 Mio. Token
524.288 bis 1.000.000 Token	1,20 $ pro 1 Mio. Token	4,80 $ pro 1 Mio. Token	0,24 $ pro 1 Mio. Token

Diese Unterscheidung ist wichtig. Ein Test mit 50.000 Token und eine Anfrage mit fast 1 Mio. Token werden nicht gleich bepreist. Wenn Sie die Kosten schätzen, berücksichtigen Sie die Prompt-Länge, die erwartete Ausgabelänge, das Cache-Verhalten, Wiederholungen und wie oft Benutzer sehr große Anfragen senden könnten.

MiniMax M3 hat derzeit ein Kontextfenster von 1.000.000 Token und eine maximale Ausgabe von 131.072 Token. Überprüfen Sie vor dem Ausliefern erneut die MiniMax M3-Modelldokumentation für die neueste Preistabelle und etwaige Ratenbegrenzungen für Ihr Konto.

Häufige Einrichtungsfehler sind:

• Fehlender oder fehlerhafter Authorization-Header.
• Verwendung der falschen Modell-ID, z. B. eines Anzeigenamens statt minimax/minimax-m3.
• Senden von Anfragen an die falsche Basis-URL.
• Setzen von max_tokens höher, als Ihre Anwendung sicher verarbeiten kann.
• Testen von Prompts mit langem Kontext ohne Berücksichtigung der höheren Preisklasse.
• Übergeben multimodaler Inhalte in einer Form, die Ihre Client-Bibliothek nicht unterstützt.

Python-Beispiel

Dieses Beispiel verwendet das OpenAI-Python-SDK mit der OpenAI-kompatiblen Basis-URL von Novita AI.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai/v1",
)

response = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[
        {
            "role": "system",
            "content": "You are a concise API assistant for software teams.",
        },
        {
            "role": "user",
            "content": "Summarize the main implementation risks in a long-context code review process.",
        },
    ],
    temperature=0.2,
    max_tokens=600,
)

answer = response.choices[0].message.content
print(answer)

Senden Sie die Anfrage mit cURL

Wenn Sie cURL bevorzugen, speichern Sie den JSON-Body in einer Variable payload. Dies macht die Anfrage lesbarer und vermeidet, den gesamten JSON-Body in einen einzigen Befehl zu packen.

payload='{
  "model": "minimax/minimax-m3",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise API assistant for software teams."
    },
    {
      "role": "user",
      "content": "Summarize the main implementation risks in a long-context code review process."
    }
  ],
  "temperature": 0.2,
  "max_tokens": 600
}'

curl --request POST "https://api.novita.ai/openai/v1/chat/completions" \
  --header "Authorization: Bearer $NOVITA_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$payload"

Wichtige Parameter

Parameter	Wofür er steht	Beginnen Sie mit
model	Welches gehostete Modell die Anfrage beantwortet	minimax/minimax-m3
messages	System- und Benutzeranweisungen	Ein kurzer, reiner Text-Prompt
temperature	Ausgabevariabilität	0.2 für wiederholbare Tests
max_tokens	Maximale generierte Ausgabe	Ein kleinerer Grenzwert, später erhöhen
stream	Ob Token progressiv gestreamt werden	Aktivieren, nachdem der Basisaufruf funktioniert
tools	Funktions-/Tool-Definitionen	Ein Tool nach dem anderen hinzufügen
response_format	Form der strukturierten Antwort	Ausgabe validieren, bevor Sie sie verwenden

Für multimodale Eingaben bestätigen Sie die exakte Anfrageform in Ihrer SDK- oder API-Dokumentation, bevor Sie sich auf Bild- oder Video-Prompts verlassen. Die Modellseite listet die Unterstützung von Modalitäten auf, aber die Formatierung der Anfrage hängt vom verwendeten Client-Pfad ab.

Fehlerbehebung

Authentifizierung schlägt fehl

Überprüfen Sie, ob NOVITA_API_KEY in derselben Shell oder Laufzeitumgebung gesetzt ist, in der Sie die Anfrage ausführen. Der Autorisierungs-Header muss das Bearer-Token-Format verwenden.

Die API findet das Modell nicht

Stellen Sie sicher, dass die Anfrage minimax/minimax-m3 verwendet, nicht MiniMax M3, minimax-m3 oder einen Blog-Titel. Modell-Anzeigenamen und Modell-IDs sind nicht austauschbar.

Die Anfrage funktioniert für kurze Prompts, schlägt aber bei langen fehl

Messen Sie die serialisierte Eingabe, nicht nur die sichtbare Wortanzahl. Tool-Schemas, abgerufene Dokumente, Bildreferenzen und der Gesprächsverlauf zählen alle. Wenn Sie sich 1.000.000 Token nähern, versuchen Sie es mit einem kleineren Prompt und fügen Sie Kürzungs- oder Abruflogik hinzu, bevor Sie es erneut versuchen.

Die Rechnung ist höher als erwartet

Überprüfen Sie, ob der Prompt in die Preisklasse von 524.288 bis 1.000.000 Token gefallen ist. MiniMax M3 hat in dieser Langkontext-Stufe höhere Preise für Eingabe, Ausgabe und Cache-Lesen.

Strukturierte Ausgabe ist inkonsistent

Beginnen Sie mit einem kleineren Schema, niedrigerer Temperatur und expliziter Validierung. Wenn Ihre Anwendung striktes JSON erfordert, behandeln Sie fehlerhafte Antworten mit Validierung und Wiederholungslogik, anstatt anzunehmen, dass jede Antwort geparst werden kann.

Tool-Aufrufe stimmen nicht mit Ihrem Funktionsschema überein

Testen Sie ein Tool nach dem anderen. Halten Sie Funktionsnamen, Beschreibungen und Parameterschemas klar und fügen Sie serverseitige Validierung hinzu, bevor Sie einen Tool-Aufruf ausführen.

FAQ

Ist MiniMax M3 über die Novita AI API verfügbar?

Ja. Die aktuelle Novita AI-Modellseite listet MiniMax M3 als verfügbar über serverlosen API-Zugriff mit der Modell-ID minimax/minimax-m3.

Was ist die Modell-ID für MiniMax M3?

Verwenden Sie minimax/minimax-m3.

Welche Basis-URL sollte ich verwenden?

Verwenden Sie https://api.novita.ai/openai als OpenAI-kompatible Basis-URL. Setzen Sie in OpenAI-SDKs die SDK-Basis-URL auf https://api.novita.ai/openai/v1.

Wie viel kostet MiniMax M3 auf Novita AI?

Die Preise für MiniMax M3 sind gestaffelt. Für Prompts unter 524.288 Token kostet die Eingabe 0,30 $ pro 1 Mio. Token, die Ausgabe 1,20 $ pro 1 Mio. Token und das Cache-Lesen 0,06 $ pro 1 Mio. Token. Für Prompts von 524.288 bis 1.000.000 Token kostet die Eingabe 1,20 $ pro 1 Mio. Token, die Ausgabe 4,80 $ pro 1 Mio. Token und das Cache-Lesen 0,24 $ pro 1 Mio. Token.

Unterstützt MiniMax M3 Streaming oder multimodale Eingabe?

Die aktuelle Modellseite listet Text-, Bild- und Videoeingaben mit Textausgabe. Das Streaming-Verhalten sollte vor dem produktiven Einsatz über den OpenAI-kompatiblen Chat-Completions-Pfad getestet werden.

Was ist das maximale Kontextfenster?

MiniMax M3 hat derzeit ein Kontextfenster von 1.000.000 Token und eine maximale Ausgabe von 131.072 Token.