MiniMax API: Schnellstart- und SDK-Leitfaden

Authentifizierung und Base URL

Verwenden Sie den bereitgestellten API-Schlüssel und weisen Sie Ihren Client der dedizierten Basis-URL zu. Der Endpunkt zur Generierung von Antworten ist https://api.minimaxaiapi.com/v1/chat/completions. Sie übergeben den Schlüssel im Authorization header als Bearer-Token. Dies funktioniert mit jedem Standard-OpenAI-SDK, weil wir demselben Protokoll folgen.

• Header-Name: Authorization
• Header-Wert: Bearer YOUR_API_KEY
• Base URL: https://api.minimaxaiapi.com/v1

Keine komplexe Einrichtung erforderlich. Aktualisieren Sie einfach die Konfiguration in Ihrem bestehenden Projekt.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Chat-Vervollständigungs-Endpunkt

Senden Sie eine POST-Anfrage an den Chat-Vervollständigungs-Endpunkt, um eine Textantwort zu erhalten. Die Modellkennung ist uncensored. Sie müssen ein messages-Array mit Ihrem Gesprächsverlauf angeben. Das System verarbeitet die Eingabe und gibt generierten Text basierend auf Ihrem Prompt zurück.

Dieser Endpunkt behandelt die gesamte Textgenerierung. Er unterstützt keine Embeddings, Audio oder Video. Sie können Antworten streamen oder auf den vollständigen Block warten. Das Modell verarbeitet einen Kontext von bis zu 100,000 Tokens insgesamt.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Streaming und Token-Nutzung

Aktivieren Sie Streaming, indem Sie stream: true in Ihrer Anfrage. Die API gibt Server-Sent Events (SSE) für jedes generierte Token zurück. Dies ermöglicht die Echtzeit-Anzeige der Ausgabe. Token-Nutzungsstatistiken sind im letzten Chunk des Streams enthalten. Dies hilft Ihnen, die Kosten genau zu verfolgen, ohne jedes einzelne Token analysieren zu müssen.

Streaming reduziert die wahrgenommene Latenz bei langen Antworten. Es ist ideal für Chat-Schnittstellen und die Generierung dynamischer Inhalte. Sie können den Stream frühzeitig stoppen, wenn der Benutzer die Generierung unterbricht.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Function Calling und JSON-Modus

Nutzen Sie die tools Parameter zur Aktivierung von Function Calling. Definieren Sie Ihre Funktionen im Request-Body und lassen Sie das Modell auswählen, welche aufgerufen werden soll. Das tool_choice Parameter ermöglicht es, eine bestimmte Funktion zu erzwingen oder automatisch auszuwählen. Für strikte JSON-Ausgaben setzen Sie response_format zu {"type": "json_object"}. Dies stellt sicher, dass die Antwort gültiges JSON ist.

Function Calling ist nützlich für die Extraktion strukturierter Daten oder das Auslösen von Aktionen. Der JSON-Modus ist perfekt für API-Integrationen, die vorhersagbare Formate erfordern. Kombinieren Sie beide für robuste Anwendungslogik.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Modellparameter und Einschränkungen

Passen Sie das Generierungsverhalten mit Standardparametern wie temperature, top_p, und stop. Das maximale Kontextfenster umfasst 100.000 Tokens, einschließlich Prompt und Antwort. Die maximale Ausgabe pro Anfrage beträgt 16.000 Tokens. Wenn Sie nicht festlegen max_tokens, das Limit beträgt standardmäßig 2.048 Tokens.

Verwenden seed für reproduzierbare Ergebnisse. Legen Sie presence_penalty und frequency_penalty um Wiederholung zu steuern. Diese Parameter geben Ihnen feinkörnige Kontrolle über die Kreativität und Konsistenz des Modells. Testen Sie immer mit Ihrem spezifischen Anwendungsfall, um das richtige Gleichgewicht zu finden.

Ratenbegrenzungen und Fehler

Wenn Sie diese Limits überschreiten, erhalten Sie einen 429-Fehler. Ein 401-Fehler zeigt einen ungültigen oder fehlenden API-Schlüssel an. Ein 402-Fehler bedeutet, dass Ihr Prepaid-Guthaben aufgebraucht ist.

Fehler verbrauchen nicht Ihr Guthaben. Sie können fehlgeschlagene Anfragen ohne Strafe wiederholen. Die Größe des Anfragekörpers ist auf 8 MB begrenzt. Verwalten Sie Ihre Parallelität sorgfältig, um Drosselung zu vermeiden. Überwachen Sie Ihre Nutzung über den letzten Chunk von Streaming-Antworten.