MiniMax API-Zugriff mit einem OpenAI-kompatiblen Router

MiniMax API-Zugriff mit einem OpenAI-kompatiblen Router ist nützlich, wenn Ihr Team MiniMax im selben Produktions-Workflow wie den Rest Ihres KI-Stacks haben möchte. Der direkte MiniMax-Pfad ist für unterstützte Sprachmodelle bereits OpenAI-SDK-kompatibel. Ein Router-Pfad ergänzt eine gemeinsame Basis-URL, eine Schlüssel-Ebene, eine Katalogprüfung, ein Nutzungsprotokoll und einen Ort, an dem entschieden wird, welche MiniMax-Workloads neben GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo und anderen Modellrouten stehen sollen.

Dieses Update wurde am 16. September 2026 anhand der offiziellen MiniMax-API-Dokumentation, der Pay-as-you-go-Preise von MiniMax, der öffentlichen Flatkey-Dokumentation, des Flatkey-Modellverzeichnisses und der Flatkey-MiniMax-Modellseiten überprüft. Betrachten Sie jedes Modell, jeden Preis und jeden Routenstatus als datierten öffentlichen Schnappschuss. Prüfen Sie Ihr Konto, den Katalog und die Bedingungen erneut, bevor Sie Produktionsverkehr senden.

Die Kurzfassung: Verwenden Sie direktes MiniMax, wenn Sie nur Zugriff auf ein MiniMax-Konto benötigen. Verwenden Sie Flatkey, wenn MiniMax innerhalb eines Multi-Provider-Router-Workflows evaluiert, budgetiert, protokolliert und zurückgerollt werden soll.

Schnelle Antwort: MiniMax API-Zugriff mit einem OpenAI-kompatiblen Router

Wenn Ihre App bereits das OpenAI Python- oder JavaScript-SDK verwendet, hat MiniMax zwei praktische Zugriffswege:

Verwenden Sie diesen Leitfaden „MiniMax API-Zugriff mit einem OpenAI-kompatiblen Router“ als Start-Checkliste. Genehmigen Sie die Migration nicht nur, weil eine Beispielantwort funktioniert hat. Genehmigen Sie sie, wenn die genaue Modell-ID, der Endpunkt, die Request-Struktur, die Preiseinheit, das Nutzungsprotokoll, die Fallback-Regel und der Rollback-Pfad alle sichtbar sind.

Was sich seit dem älteren MiniMax-Artikel geändert hat

Der ältere öffentliche Artikel war auf den 16. Juni 2026 datiert. Die sichere Aktualisierung ist keine kosmetische Überarbeitung. MiniMax und Flatkey haben sich beide genug verändert, dass der Artikel eine aktuelle Routensprache benötigt.

Die wichtigsten Aktualisierungen sind:

• MiniMax dokumentiert jetzt MiniMax-M3 als das neueste von der OpenAI-SDK unterstützte Sprachmodell der M-Serie, mit einem Kontextfenster von 1.000.000 Tokens und Unterstützung für Bild-/Videoeingaben über OpenAI-kompatible Message-Content-Parts.
• Die Videoerzeugung V2 von MiniMax dokumentiert jetzt MiniMax-H3 und MiniMax-H3-Max über einen asynchronen POST /v2/video_generation-Ablauf.
• Die Pay-as-you-go-Preisgestaltung von MiniMax trennt jetzt die M3-Textpreise nach Kontextschwelle und Servicestufe, die H3-Video-Preise nach Modell/Auflösung/Sekunden, die Bildpreise pro generiertem Bild, die Sprachpreise pro Stunde oder Zeichen sowie die MCP-/Tool-Preise pro Anfrage.
• Die öffentlichen Flatkey-Dokumente stellen MiniMax-H3 über den gemeinsam genutzten asynchronen POST /v1/videos-Video-Workflow bereit.
• Die während dieser Aktualisierung geprüften öffentlichen Modellseiten von Flatkey lieferten 200 für https://flatkey.ai/models/minimax-h3 und https://flatkey.ai/models/minimax-m2.7; https://flatkey.ai/models/minimax-m3 lieferte 404. Das bedeutet, dass dieser Artikel keinen verifizierten Flatkey-M3-Pfad behauptet.

Dieser letzte Punkt ist wichtig. Ein Artikel über einen Router sollte Teams dabei helfen, veraltete Annahmen zu Modellnamen zu vermeiden. Wenn Sie M3 über Flatkey nutzen möchten, prüfen Sie das Live-Modellverzeichnis, /v1/models, oder Ihre Konsole, bevor Sie den Produktionsverkehr konfigurieren.

Quellenfakten, die Sie vor dem Routing von MiniMax festhalten sollten

Verwenden Sie diese Quellentabelle, bevor Sie Code ändern:

Das ist die wichtigste Produktionsgewohnheit hinter MiniMax API Access With One OpenAI-Compatible Router: das Quellendatum speichern, die Modell-ID speichern und den Evidenzpfad speichern. Modellkataloge ändern sich zu häufig, als dass kopierte Snippets die letzte Instanz sein könnten.

Direktes MiniMax OpenAI-SDK-Setup

Das direkte MiniMax-Setup ist der sauberste erste Test, wenn Sie das herstellereigene Verhalten verstehen müssen.

export OPENAI_BASE_URL="https://api.minimax.io/v1"
export OPENAI_API_KEY="your-minimax-api-key"
export MINIMAX_MODEL="MiniMax-M3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ["OPENAI_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ.get("MINIMAX_MODEL", "MiniMax-M3"),
    messages=[
        {"role": "user", "content": "Return one sentence confirming the MiniMax route works."}
    ],
    max_completion_tokens=120,
    extra_body={
        "thinking": {"type": "disabled"}
    },
)

print(response.choices[0].message.content)
print(response.usage)

Nutzen Sie direktes MiniMax, um zuerst das Verhalten des Anbieters kennenzulernen:

• Benötigt Ihre App MiniMax-Thinking-Output oder direkte Antworten?
• Toleriert Ihr Stream-Handler die Antwortfelder von MiniMax?
• Hängt Ihre Tool-Call-Schleife die vollständige Assistentennachricht an, wenn erforderlich?
• Verlässt sich Ihr Parser auf Parameter, die MiniMax ignoriert?
• Verwendet Ihre Workload Bild- oder Videoeingabeteile mit MiniMax-M3?
• Erwartet Ihre App versehentlich Audioeingaben im OpenAI-kompatiblen Chat-Pfad?

Dieser direkte Test gibt Ihnen die Basislinie, bevor Sie MiniMax hinter einen Router setzen.

Flatkey-Einrichtung für MiniMax über einen Router

Für Flatkey ist die Einrichtung des OpenAI-kompatiblen Clients dasselbe Muster wie bei anderen Modellen: Verwenden Sie einen Flatkey-Schlüssel, setzen Sie die Flatkey-Router-Basis-URL und wählen Sie eine Modell-ID, die im aktuellen Flatkey-Katalog vorhanden ist.

export FLATKEY_API_KEY="sk-your-flatkey-key"
export OPENAI_BASE_URL="https://router.flatkey.ai/v1"

# Beispiel für öffentliche Chat-Route, in dieser Aktualisierung verifiziert.
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# Beispiel für öffentliche Video-Route, in dieser Aktualisierung verifiziert.
export FLATKEY_MINIMAX_VIDEO_MODEL="MiniMax-H3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)

response = client.chat.completions.create(
    model=os.environ["FLATKEY_MINIMAX_TEXT_MODEL"],
    messages=[
        {"role": "user", "content": "Geben Sie einen Satz zurück, der bestätigt, dass die Flatkey-MiniMax-Route funktioniert."}
    ],
    max_tokens=120,
)

print(response.choices[0].message.content)
print(response.usage)

Dies ist das grundlegende Muster für den MiniMax-API-Zugriff mit einem OpenAI-kompatiblen Router. Der Code bleibt gewöhnlich, aber die Modell-ID muss an dem Tag, an dem Sie testen, von Flatkey stammen. Wenn der aktuelle Katalog MiniMax-M3 anzeigt, verwenden Sie die exakte aktuelle Zeichenfolge. Wenn nicht, fügen Sie die direkte MiniMax-Modell-ID nicht in eine Flatkey-Route ein und gehen Sie nicht davon aus, dass sie funktionieren wird.

Video: MiniMax H3 über Flatkey

Für Medienteams geht es beim MiniMax-API-Zugriff oft eher um Video als um Chat. Flatkey dokumentiert MiniMax-H3 über einen dedizierten asynchronen Video-Workflow:

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "Ein Papierboot überquert eine Regenpfütze in einer filmischen Makroaufnahme"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

Der MiniMax-H3-Leitfaden von Flatkey sagt, dass die Antwort eine id und eine task_id enthält. Speichern Sie sie, fragen Sie GET /v1/videos/{task_id} ab und laden Sie dann die Datei von metadata.url herunter, wenn die Aufgabe abgeschlossen ist.

Die Videoeinrichtung ist nicht mit einer Chat-Completions-Anfrage austauschbar:

• MiniMax-H3 verwendet die Array-Struktur content.
• resolution ist groß-/kleinschreibungssensitiv und akzeptiert im Flatkey-Leitfaden 768P oder 2K.
• duration ist eine ganze Zahl von 4 bis 15 Sekunden.
• Text-only-Anfragen benötigen ein nicht-adaptive Verhältnis.
• Referenzmedien sowie Steuerelemente für erstes/letztes Bild haben unterschiedliche Rollenregeln.
• Die Nutzungsfelder geben für H3-Videoantworten Sekunden an, nicht Tokens eines Sprachmodells.

Wenn Ihr Produkt auch Seedance, Veo oder andere Videomodelle vergleicht, kombinieren Sie diesen Artikel mit Flatkeys Prüfungen zum Video-Routing über mehrere Anbieter. Entscheidend ist nicht nur, ob eine Videoaufgabe erfolgreich ist. Entscheidend ist, ob Output-Vertrag, Kosteneinheit, Queue-Verhalten, Fehlerzustand und Fallback-Regel für den Workflow akzeptabel sind.

MiniMax-Preiseinheiten zum Normalisieren

Bei den Preisen kann der Zugriff auf die MiniMax-API mit einem OpenAI-kompatiblen Router schiefgehen. MiniMax ist nicht eine Preistabelle. Es sind mehrere Preiseinheiten.

Flatkey-Preise und Gruppenmultiplikatoren sind getrennt von den direkten MiniMax-Preisen. Die direkte Anbietertabelle zeigt Ihnen, wie MiniMax ein MiniMax-Konto abrechnet. Eine Flatkey-Routing-Entscheidung sollte die aktuelle Flatkey-Modellzeile, Ihre Kontogruppe und das Nutzungsprotokoll nach einer Testanfrage verwenden.

Verwenden Sie diese Formel für Medien- und Creator-Workflows:

accepted_output_cost:
  provider_or_router_cost: "sum of all attempts"
  accepted_outputs: "clips, images, audio files, or responses that passed review"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - retries
    - fallback attempts
    - rejected outputs
    - regeneration
    - review lane
    - storage handoff

Das günstigste erzeugte Ergebnis ist nicht immer das günstigste akzeptierte Ergebnis.

Kompatibilitäts-Smoketest

Führen Sie diesen Smoketest aus, bevor Sie produktiven Traffic umstellen:

Die Bestehensbedingung ist ein Beleg, nicht Vertrauen. Speichern Sie eine Anfrage-ID oder Task-ID, eine Modell-ID, einen Zeitstempel, den Routenpfad, einen Screenshot oder Export des Usage-Logs und die endgültige Kosteneinheit.

Kopierbarer MiniMax-Route-Review-Datensatz

Verwenden Sie diese Vorlage in Ihrem Launch-Issue oder Routing-Repository:

minimax_route_review:
  checked_at_utc: "2026-09-16T00:00:00Z"
  owner: "media_platform_team"
  workload: "creator_video_draft | support_chat | voiceover | image_draft"
  route_mode: "direct_minimax | flatkey | dual_route_test"
  direct_minimax:
    base_url: "https://api.minimax.io/v1"
    model_id: "MiniMax-M3"
    docs_checked:
      - "https://platform.minimax.io/docs/api-reference/text-openai-api.md"
      - "https://platform.minimax.io/docs/guides/pricing-paygo.md"
  flatkey:
    base_url: "https://router.flatkey.ai/v1"
    model_id: "replace_with_current_flatkey_model_id"
    catalog_url: "https://flatkey.ai/models"
    model_page_status: "200 | 404 | account_only"
    usage_logs_verified: false
  endpoint_contract:
    path: "/v1/chat/completions | /v1/videos"
    request_shape: "chat_messages | content_array | prompt_string"
    streaming_required: false
    tool_calls_required: false
    image_input_required: false
    video_input_required: false
  cost_review:
    provider_unit: "tokens | seconds | characters | images | hours | requests"
    flatkey_unit: "aktuelle Zeile erfassen"
    accepted_output_cost_target: "USD"
  fallback_policy:
    fallback_enabled: false
    fallback_models: []
    allowed_failure_classes:
      - "timeout"
      - "upstream_5xx"
    blocked_failure_classes:
      - "safety_block"
      - "unsupported_feature"
  rollout:
    first_environment: "staging"
    production_slice: "0%"
    rollback_owner: "engineering"
    next_review_date: "YYYY-MM-DD"

Dieser Datensatz macht MiniMax API-Zugriff mit einem OpenAI-kompatiblen Router zu einer überprüfbaren Entscheidung. Jede Person sollte sehen können, welches Modell getestet wurde, welcher Pfad es verarbeitet hat, welche Kosteneinheit freigegeben wurde und welches Fallback-Verhalten erlaubt ist.

Wann Direct MiniMax ausreicht

Verwenden Sie Direct MiniMax, wenn:

• MiniMax der einzige Anbieter im Workflow ist.
• Sie ein neu veröffentlichtes MiniMax-Modell benötigen, bevor es in einem Gateway-Katalog erscheint.
• Sie eine anbietereigene Funktion benötigen, die der Router nicht bereitstellt.
• Einkauf oder Datenrichtlinie direkte Anbieter-Kontrollen erfordern.
• Ihr Team MiniMax-Verhalten noch kennenlernt und eine saubere Ausgangsbasis möchte.

Der direkte Zugriff ist kein Architekturfehler. Er ist der richtige Weg, wenn Anbieterspezifikität wichtiger ist als Zentralisierung.

Wann Flatkey der sauberere Weg ist

Verwenden Sie Flatkey, wenn MiniMax ein Pfad in einem größeren Modellsystem ist:

• Das Produkt vergleicht MiniMax mit GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo oder anderen Anbietern.
• Ein Creator-Workflow benötigt Text-, Bild-, Sprach- und Videorouten unter einem Prüfprozess.
• Die Finanzabteilung einen Usage-Trace auf Anfrageebene statt mehrerer Provider-Konsolen möchte.
• Plattformverantwortliche Sub-Keys, Kontingente, Modell-Whitelists, Routenprüfungen oder Rollback-Kontrollen benötigen.
• Das Team bereits OpenAI-SDK-Clients nutzt und die Modellauswahl in der Konfiguration haben möchte.
• Fallback- und Routen-Health-Entscheidungen nachvollziehbar sein müssen.

Flatkey entfernt das providerseitige Testen nicht. Es macht das Testen und den Nachweis über mehrere Anbieter hinweg einfacher zu verwalten.

Häufige Fehler

• Anmeldedaten vermischen: Ein MiniMax-Schlüssel gehört zur MiniMax-Base-URL, und ein Flatkey-Schlüssel gehört zur Flatkey-Base-URL.
• MiniMax-M3 in Flatkey-Code zu verwenden, ohne zu prüfen, ob der aktuelle Flatkey-Katalog genau diese Route anbietet.
• Die direkte OpenAI-SDK-Kompatibilität von MiniMax als vollständige Parität zur OpenAI-API zu behandeln.
• MiniMax-Hinweise zu nicht unterstütztem, veraltetem function_call, n: 1, ignorierten Parametern und Audioeingabe im OpenAI-kompatiblen Chat-Pfad zu ignorieren.
• Nur Chat zu testen, obwohl die Produktivlast Streaming, Tools, Bildeingaben, Videoeingaben oder asynchrone Videojobs verwendet.
• Tokenpreise, Videosekunden, Sprachzeichen und Bildpreise in einer Tabelle zu vergleichen, ohne nach akzeptierter Ausgabe zu normalisieren.
• Fallback von einem Videomodell auf ein anderes zu aktivieren, ohne Dauer, Auflösung, Audio-/Referenzunterstützung und Moderationsverhalten zu prüfen.
• Beispielcode mit echt aussehenden Schlüsseln oder veralteten Modell-IDs zu veröffentlichen.

Interne Links für den nächsten Schritt

Wenn dies Ihre erste Flatkey-Migration ist, beginnen Sie mit dem Flatkey-API-Quickstart und dem umfassenderen Workflow für die einheitliche KI-API. Für die Prüfung von Modellzeilen verwenden Sie den Leitfaden zum KI-Modellkatalog. Für die Videorichtlinie kombinieren Sie dies mit Seedance vs Veo API-Routing, der Checkliste für den Veo-API-Zugriff und dem Leitfaden Multimodales Agenten-Routing.

Häufig gestellte Fragen

Wie erhalte ich Zugriff auf die MiniMax-API?

Sie können den MiniMax-API-Zugriff direkt über die MiniMax-Plattform mit einem Pay-as-you-go-API-Schlüssel erhalten oder unterstützte MiniMax-Modelle über Flatkey mit einem Flatkey-Schlüssel und https://router.flatkey.ai/v1 routen. Verwenden Sie direktes MiniMax für providerspezifisches Testen und Flatkey für Multi-Provider-Routing, Protokolle, Rechnungsprüfung und Fallback-Richtlinien.

Ist die MiniMax-API OpenAI-kompatibel?

MiniMax dokumentiert die Nutzung des OpenAI SDK mit https://api.minimax.io/v1 als Base-URL für unterstützte Sprachmodelle. Die Kompatibilität ist auf Feature-Ebene. MiniMax dokumentiert Hinweise zu ignorierten OpenAI-Parametern, n: 1, dem nicht unterstützten veralteten function_call und dazu, dass im OpenAI-kompatiblen Chat-Nachrichteninhaltspfad keine Audioeingabe unterstützt wird.

Welches aktuelle MiniMax-Sprachmodell sollte ich zuerst prüfen?

Die offiziellen MiniMax-Dokumente führen MiniMax-M3 als das neueste Sprachmodell der M-Serie mit einem Kontextfenster von 1.000.000 Tokens und multimodaler Unterstützung für Bild- und Videoeingaben auf. Prüfen Sie bei Flatkey den Live-Katalog, bevor Sie davon ausgehen, dass genau diese Modell-ID über den Router verfügbar ist.

Kann ich MiniMax-M3 über Flatkey verwenden?

Gehen Sie nicht allein anhand der direkten MiniMax-Dokumentation davon aus. Während dieser Aktualisierung vom 16. September 2026 lieferte die öffentliche Flatkey-Detailseite für das Modell minimax-m3 einen 404, während minimax-m2.7 und MiniMax-H3 einen 200 zurückgaben. Prüfen Sie Ihr aktuelles Flatkey-Modellverzeichnis, /v1/models oder die Konsole, bevor Sie M3 über Flatkey konfigurieren.

Wie verwende ich MiniMax-H3-Video über Flatkey?

Verwenden Sie POST https://router.flatkey.ai/v1/videos mit dem Modell MiniMax-H3, einem content-Array, resolution von 768P oder 2K, einer Dauer von 4 bis 15 und einem gültigen Seitenverhältnis. Speichern Sie die zurückgegebene Task-ID, fragen Sie GET /v1/videos/{task_id} ab und laden Sie die Datei nach Abschluss von metadata.url herunter.

Wie sollte ich die MiniMax-Preisgestaltung über einen Router vergleichen?

Gehen Sie vom direkten MiniMax-Einheitspreis aus und prüfen Sie dann die Flatkey-Modellzeile und Ihr Nutzungsprotokoll. Text verwendet Token-Einheiten, Video verwendet Sekunden, Sprache kann Stunden oder Zeichen verwenden, Bilderzeugung nutzt eine Preisgestaltung pro Bild, und Tools können eine Preisgestaltung pro Anfrage verwenden. Vergleichen Sie die Kosten pro akzeptierter Ausgabe nach Wiederholungen und abgelehnten Ausgaben, nicht nur den Listenpreis.

Ersetzt Flatkey das direkte Testen von MiniMax-Routen?

Nein. Flatkey kann Schlüsselverwaltung, Modellrouting, Nutzungsprotokolle und Rechnungsprüfung zentralisieren, aber Sie müssen weiterhin das genaue Modell, den Endpoint, die Request-Struktur, die Preiseinheit, die Fallback-Regel und das Fehlverhalten testen, das Ihr Produkt verwenden wird.

Fazit

MiniMax-API-Zugriff mit einem OpenAI-kompatiblen Router sollte mit einem datierten Routing-Eintrag enden, nicht nur mit einer geänderten base_url. Bestätigen Sie das direkte MiniMax-Verhalten, wählen Sie die exakte Flatkey-Modellzeile, wenn Sie über Flatkey routen, führen Sie Chat- und Video-Smoke-Tests getrennt aus, normalisieren Sie die Preisgestaltung anhand der akzeptierten Ausgabe und halten Sie Rollback in der Konfiguration fest. Verwenden Sie dann Flatkeys Modellverzeichnis, Preisübersichtsseite, Quickstart, Videodokumentation und Nutzungsprotokolle, um MiniMax im selben operativen Prüfzyklus wie den Rest Ihres Modellstacks zu halten.

Für Media- und Produktteams ist MiniMax-API-Zugriff mit einem OpenAI-kompatiblen Router die praktische Gewohnheit, jeden Modellstart als Routing-Entscheidung mit beigefügten Nachweisen zu behandeln.