DE ▾

MiniMax-API-Einrichtung: Schlüssel, Basis-URL und erste Anfrage

Dies ist eine Schritt-für-Schritt-Einrichtung der OpenAI-kompatiblen API auf minimaxapikey.com: Konto, Schlüssel, Basis-URL, erste Anfrage. Es ist ein unabhängiger Dienst, nicht die offizielle API eines Modell-Anbieters.

Aktualisiert

Sechs leuchtende Schritte, die von einem Schlüssel zu einem Server-Rack führen und den API-Einrichtungspfad darstellen

Wichtige Punkte

  • Registriere dich mit Google oder E-Mail und beanspruche dann $0,50 Testguthaben auf der Schlüssel-Seite. Keine Karte erforderlich.
  • Die Basis-URL ist https://api.minimaxapikey.com/v1, die Modell-ID ist uncensored, die Authentifizierung erfolgt über einen Bearer-Schlüssel.
  • Es gibt zwei Methoden: POST /v1/chat/completions und GET /v1/models.
  • Ein 401 bedeutet einen falschen Schlüssel, und ein 429 bedeutet, dass ein Limit erreicht wurde, also prüfe den Fehlercode im Antworttext.

Was du einrichtest

Die Leute suchen nach MiniMax-API-Einrichtung und erwarten eines von zwei Dingen: die offizielle MiniMax-Entwicklerplattform oder einen sofort einsetzbaren OpenAI-ähnlichen Endpunkt. Diese Seite behandelt Letzteres. Der Dienst hinter minimaxapikey.com ist eine gehostete, OpenAI-kompatible Text-API, die ein einzelnes Open-Weight-Modell betreibt, betrieben von einem unabhängigen Anbieter. Es ist nicht die offizielle API von MiniMax oder eines anderen Modell-Anbieters, und es leitet Anfragen nicht über Anbieter hinweg weiter. Wenn du die Plattform des Anbieters selbst benötigst, nutze deren Website.

Was du bekommst, ist einfach. Sobald du die Base URL und den API-Schlüssel änderst, funktioniert jedes OpenAI SDK oder jeder Client. Es gibt zwei Methoden, POST /v1/chat/completions und GET /v1/models, eine Modell-ID, uncensored und ein Kontextfenster mit 100.000 Token, das sich Prompt und Completion teilen. Es unterstützt nur Text, also keine Bild-, Audio- oder Videoerzeugung, keine Embeddings und kein Fine-Tuning. Streaming, Function Calling und JSON-Modus werden unterstützt.

Die gesamte Einrichtung dauert nur wenige Minuten. Die folgenden Schritte sind in der richtigen Reihenfolge, und jeder endet mit einer Überprüfung, damit du weißt, dass er funktioniert hat, bevor du fortfährst.

Schritt 1 und 2: Konto erstellen und Testguthaben sichern

  1. Öffne die Schlüssel-Seite. Gehe zur API-Schlüssel-Seite und melde dich an. Du kannst Google oder eine E-Mail-Adresse mit Passwort verwenden.
  2. Beanspruche das Testguthaben. Nach der Anmeldung hat die Schlüssel-Seite eine Schaltfläche für $0,50 Testguthaben. Es ist ein Klick, benötigt keine Karte, ist 7 Tage gültig und pro Person auf eine Nutzung begrenzt.

Das Testguthaben ist absichtlich klein. Bei $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token deckt $0,50 eine gute Anzahl von Testanfragen ab. Ein Prompt mit 1.000 Token und eine Antwort mit 500 Token kostet $0,00015 für Input plus $0,00025 für Output, also $0,0004. Die Division von $0,50 durch diesen Betrag ergibt 1.250 solcher Anfragen, also hast du viel Platz zum Experimentieren.

Beachte die Limits des Test-Schlüssels: 2 parallele Anfragen und 60 Anfragen pro Minute. Ein vollständiger Schlüssel, den du erhältst, nachdem du aufgeladen hast, erlaubt 8 parallele Anfragen und 300 pro Minute. Wenn deine Test-Schleife parallel läuft und du 429-Fehler siehst, ist dies das Erste, das du prüfen solltest.

Schritt 3: Schlüssel erstellen und sicher speichern

Erstelle auf derselben Seite einen API-Schlüssel und kopiere ihn. Behandle ihn wie ein Passwort. Speichere ihn in einer Umgebungsvariable oder einem Secrets-Manager, niemals in einem Repository, einem Frontend-Bundle oder einem Screenshot. Wenn ein Schlüssel geleakt wird, entferne ihn und erstelle einen neuen.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

Serverseitiger Code sollte die Variable zur Laufzeit lesen. Browser-Code sollte den Schlüssel überhaupt nicht halten: Sende Anfragen stattdessen von deinem Backend, denn alles, was an den Browser ausgeliefert wird, ist für jeden Besucher sichtbar.

Schritt 4: Modelle auflisten, um den Schlüssel zu bestätigen

Der günstigste mögliche Test ist der Endpunkt für Modelle. Er generiert keinen Text, also ist er eine saubere Überprüfung des Schlüssels, der URL und deines Netzwerks.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

Du solltest eine JSON-Liste erhalten, die uncensored enthält. Wenn du einen 401-Fehler erhältst, ist der Schlüssel falsch oder enthält ein fremdes Leerzeichen oder Anführungszeichen. Wenn die Verbindung fehlschlägt, überprüfe, ob die URL mit /v1 endet und ob du https verwendet hast.

Schritt 5: erste Chat-Anfrage senden

Jetzt eine echte Vervollständigung. Der Body hat die Standard-Struktur für Chat-Vervollständigungen.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

Die Antwort enthält choices[0].message.content und einen usage-Block mit Token-Anzahlen für Prompt und Vervollständigung. Schau dir auch die Antwort-Header an, mit curl -i. Du siehst X-Request-Id, das Support bei der Suche nach deiner Anfrage hilft, X-Balance-USD, dein verbleibendes Guthaben, und die Ratenlimit-Header X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency.

Parameter wie temperature, top_p, stop, seed und die Penalties werden durchgereicht. max_tokens ist optional. Wenn du es weglässt, kann die Vervollständigung den Rest des Fensters nutzen.

Schritt 6: dieselbe Anfrage über ein SDK

Sobald curl funktioniert, wechsle zu der Sprache, die du tatsächlich verwenden wirst. Nur zwei Argumente ändern sich gegenüber einer Standard-OpenAI-Einrichtung.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.minimaxapikey.com/v1",
    api_key=os.environ["UNCENSORED_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.minimaxapikey.com/v1",
  apiKey: process.env.UNCENSORED_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

Für das Streaming füge stream: true hinzu und lese die Server-Sent Events. Die Nutzungszahlen werden am Ende des Streams übermittelt. Die Dokumentationsseite behandelt Streaming, Function Calling und JSON-Modus mit response_format: {"type":"json_object"}.

Ein bestehendes OpenAI-Projekt migrieren

In den meisten Fällen funktioniert das Projekt, das du verbinden möchtest, bereits mit der OpenAI-Client-Bibliothek. In diesem Fall bearbeitest du den Code selten überhaupt. Die offiziellen SDKs lesen die Umgebungsvariablen OPENAI_API_KEY und OPENAI_BASE_URL, wenn du keine Argumente übergibst, also kann eine Änderung der Bereitstellung ausreichen.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

Die verbleibende Änderung ist der Modellname. Eine Zeichenfolge wie eine OpenAI-Modell-ID wird hier nicht existieren, also ersetze sie durch uncensored, idealerweise über einen Konfigurationswert, damit du zurückwechseln kannst. Lies dann den Code durch, um nach Funktionen zu suchen, die der Dienst nicht anbietet. Bildgenerierung, Audio, Embeddings und Fine-Tuning sind nicht verfügbar, da dies eine Text-Only-Chat-API ist. Wenn deine App Embeddings für die Suche aufruft, benötigst du für diesen Teil einen anderen Anbieter und kannst den Chat auf diesem belassen.

Es hilft auch zu wissen, was das Modell ist. Es ist ein einzelnes Open-Weight-Modell, das darauf abgestimmt ist, für die legale Nutzung durch Erwachsene ohne Inhaltsablehnungen zu antworten, und eine harte Grenze gilt unabhängig von den Einstellungen: keine sexuellen Inhalte mit Minderjährigen. Prompts, die für ein anderes Modell geschrieben wurden, benötigen möglicherweise kleine Anpassungen, da jedes Modell auf denselben System-Prompt unterschiedlich reagiert. Führe deine eigenen Test-Prompts nebeneinander aus, bevor du echten Traffic umschaltest.

Einstellungen, die sich am ersten Tag lohnen

Einige Entscheidungen sind zur Einrichtungszeit einfacher zu treffen als nach dem Launch. Keine davon ist schwierig, aber jede vermeidet später eine Überraschung.

  • Ein System-Prompt. Lege deine Anweisungen zu Tonfall, Format und Rolle in eine system-Nachricht. Halte sie kurz und spezifisch, da jede Anfrage sie als Input-Token wiederholt.
  • Eine Token-Obergrenze. max_tokens ist optional, aber eine Obergrenze ist ein günstiger Schutz. Ohne sie kann eine einzelne Antwort den Rest des 100.000-Token-Fensters nutzen.
  • Streaming für interaktive Nutzung. Setze stream: true, wenn eine Person auf die Antwort wartet. Für Batch-Jobs sind normale Anfragen einfacher.
  • Eine Retry-Regel für 429. Behandle 429 als Signal zu warten, nicht als Fehler. Wenn die Antwort Retry-After: 5 enthält, ist es die richtige Entscheidung, so lange zu schlafen und erneut zu versuchen.
  • Anfragegröße. Die Body-Grenze beträgt 8 MB. Das ist weit mehr als ein normaler Prompt benötigt, aber eingefügte Logs oder Dokumente können dies erreichen.

Prompts werden nicht zum Training verwendet, was wichtig ist, wenn du interne Dokumente oder Benutzer-Nachrichten senden möchtest. Du bist weiterhin für das verantwortlich, was du sendest, also vermeide es, Geheimnisse, die das Modell nicht benötigt, in einen Prompt zu geben.

Aufladen nach dem Testguthaben

Das Testguthaben dient dazu, zu prüfen, ob alles funktioniert. Wenn du bereit bist zu bauen, füge Prepaid-Guthaben hinzu. Es gibt kein Abonnement: Du zahlst für genutzte Token, bei $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token, und Guthaben verfällt nie, also verschwindet ein nicht genutzter Saldo nicht am Ende eines Monats.

Jeder ganze Betrag von $20 bis $500 funktioniert. Ein Top-up von $50 fügt einen 5-%-Bonus hinzu, $100 fügt 10 % hinzu und $200 fügt 15 % hinzu. Als schnelles Beispiel: Ein Top-up von $100 mit seinem 10-%-Bonus ergibt $110 Guthaben. Bei dem 1.000-Token-Prompt und der 500-Token-Antwort aus Schritt zwei kostet jede Anfrage $0,0004, also deckt $110 275.000 Anfragen ab. Echte Prompts sind normalerweise länger, also skaliere diese Zahl auf deinen eigenen Durchschnitt.

Häufige Einrichtungsfehler beheben

SymptomWahrscheinliche UrsacheLösung
401 bei jeder AnfrageFehlender, falsch getippter oder widerrufener SchlüsselSende Authorization: Bearer <key>, ohne zusätzliche Anführungszeichen
404 oder HTML-AntwortFalscher Pfad, meist ein fehlendes /v1Verwende die vollständige Basis-URL, die mit /v1 endet
Modell nicht gefundenEin Modellname, der von einem anderen Anbieter kopiert wurdeVerwende uncensored
429 mit rate_limitedÜber dem Anfragen-pro-Minute-LimitVerlangsame, oder lade auf, um von Testlimits auf volle Limits zu wechseln
429 mit concurrencyZu viele Anfragen gleichzeitigBegrenze parallele Aufrufe auf 8 (2 bei einem Test-Schlüssel)
429 mit Retry-After: 5Vorübergehende ÜberlastungWarte 5 Sekunden und versuche es erneut
413 oder Body abgelehntAnfrage über 8 MBKürze den Prompt oder teile die Aufgabe auf

Wenn du bereit bist, mehr als das Testguthaben zu nutzen, listet die Preisseite die Auflade-Optionen auf: jeden beliebigen Gesamtbetrag von $20 bis $500, zahlbar mit Krypto (USDT auf TRC20, USDC auf Base), mit einem Bonus von 5 % ab $50, 10 % ab $100 und 15 % ab $200. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und Prompts werden nicht zum Training verwendet.

Fragen und Antworten

Ist dies die offizielle MiniMax-API?

Nein. Es ist eine unabhängige, gehostete, OpenAI-kompatible API, die ein Open-Weight-Modell bedient, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die legale Nutzung durch Erwachsene zu antworten. Es ist nicht die offizielle API eines Modell-Anbieters und kein Router über Anbieter hinweg.

Brauche ich eine Kreditkarte, um es auszuprobieren?

Nein. Nach der Anmeldung kannst du $0,50 an Testguthaben mit einem Klick auf der API-Schlüssel-Seite beanspruchen. Es ist 7 Tage gültig und auf einen pro Person begrenzt.

Wie heißt das Modell, das ich in Anfragen verwenden soll?

Verwende uncensored. Der Dienst stellt diese einzelne Modell-ID bereit, und GET /v1/models zeigt sie an.

Wie füge ich später mehr Guthaben hinzu?

Lade jeden beliebigen Gesamtbetrag von $20 bis $500 auf. Boni gelten ab $50 (+5 %), $100 (+10 %) und $200 (+15 %), und das Guthaben verfällt nie.

Kann ich das OpenAI SDK verwenden?

Ja. Setze base_url auf https://api.minimaxapikey.com/v1, verwende deinen Schlüssel und sende das Modell uncensored. Nichts anderes in deinem Code muss geändert werden.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhalten