Mukenetsu AI API Schnellstart

Grundkonfiguration und Base URL

Mukenetsu AI ist als OpenAI-kompatible REST API konzipiert. So kannst du bestehende OpenAI-Clients und SDKs mit minimalen Änderungen nutzen. Verwende die folgende Base URL für die Kommunikation.

https://api.mukenetsuapi.com/v1

Im Gegensatz zu anderen LLM-Diensten brauchst du keine komplexe Endpunkt-Auswahl oder zusätzliche Konfiguration. Es gibt nur einen Chat-Completion-Endpunkt und einen Endpunkt für die Modellliste. Diese Einfachheit beschleunigt die Entwicklung.

Den API-Schlüssel erhältst du sofort nach dem Sign-up auf der Seite Get API key mit deiner E-Mail-Adresse und deinem Passwort. Du musst nichts im Dashboard tun. Außerdem ist deine Privatsphäre geschützt: Deine Prompt-Daten werden nicht zum Trainieren von Modellen verwendet.

Authentifizierung und API-Schlüssel

Der Zugriff auf die API erfordert die Authentifizierung über den Header Authorization: Bearer <API_KEY>. Verwende den bei der Kontoerstellung generierten Schlüssel. Pro Konto gibt es einen Schlüssel, den du jederzeit neu generieren kannst. Achte darauf: Nach der Neugenerierung wird der alte Schlüssel ungültig.

Bei Authentifizierungsfehlern erhältst du meist 401 (Unauthorized) oder 402 (Payment Required). 401 bedeutet, der Schlüssel ist falsch oder ungültig; 402 bedeutet, dein Guthaben reicht nicht aus. Guthaben ist Prepaid und kann ab $10 mit Kryptowährungen (USDT, USDC) aufgeladen werden.

Chat-Completion-Endpunkt

Der Haupt-Endpunkt für die Textgenerierung ist POST /v1/chat/completions. Durch das Senden einer Anfrage an diesen Endpunkt kannst du Text generieren, einschließlich des Gesprächsverlaufs und des System-Prompts. Gib als Modell-ID uncensored an. Dies ist ein eigenes Open-Weight-Modell, das sich von GPT von OpenAI oder Modellen anderer Anbieter unterscheidet.

Das folgende Beispiel zeigt die grundlegende Textgenerierung mit curl. Die erforderlichen Parameter sind die Modell-ID, die Nachrichten und optional die Aktivierung des Streamings.

コピーcurl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Dieser Endpunkt bietet keine Embeddings, Bildgenerierung oder Stimmumwandlung. Er ist rein auf Text-Completion und -Generierung spezialisiert.

Streaming (SSE)

Wenn du generierten Text in Echtzeit erhalten möchtest, nutze den Streaming-Modus. Durch Hinzufügen von "stream": true sendet der Server Daten sequenziell im SSE-Format. So kannst du Text anzeigen, bevor die Generierung abgeschlossen ist.

Wenn du die Python OpenAI SDK oder die Node.js Client-Bibliothek nutzt, wird das Streaming automatisch aktiviert, wenn du die Option stream=True angibst. Der Event-Handler empfängt Chunks pro Token.

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.mukenetsuapi.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 verbessert die User Experience bei langen Antworten oder interaktiven Anwendungen. Bei einem Verbindungsabbruch während des Streamings werden jedoch keine weiteren Events empfangen.

Tools/Funktion-Aufrufe

Die Mukenetsu AI API unterstützt Tool-Funktion-Aufrufe. Dies erleichtert die Integration externer APIs oder Datenbanken. Füge den Body mit dem Feld tools und dem Parameter tool_choice hinzu, um das Modell zu einem bestimmten Funktionsaufruf zu bewegen.

Das Modell entscheidet, ob es eine Funktion aufruft oder normalen Text zurückgibt. Nach Abschluss des Aufrufs kannst du das Funktionsergebnis zu messages hinzufügen und an das Modell übergeben, um detailliertere Antworten zu erhalten.

コピーimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mukenetsuapi.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);

Diese Funktion ist besonders nützlich für Agenten-Anwendungen und die Automatisierung komplexer Aufgaben. Da das OpenAI-kompatible Format verwendet wird, kannst du bestehende Logik für Funktion-Aufrufe direkt übernehmen.

Ratenlimit und Einschränkungen

Die API unterliegt folgenden Limits: Maximal 300 Anfragen pro Minute und eine maximale Body-Größe von 8 MB. Bei Überschreitung wird ein 429-Fehler (Too Many Requests) zurückgegeben. Das Kontextfenster beträgt 100.000 Token (Prompt + generierter Text). Längere Konversationen müssen aufgeteilt werden.

Bei der Empfangnahme von Streaming-Antworten folge diesem Event-Fluss.

コピーstream = 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)

Sexuelle Inhalte mit Minderjährigen sind streng eingeschränkt, wie es das Gesetz vorschreibt. Andere rechtlich zulässige Erwachseneninhalte, Fiktion, Sicherheitsforschung und kontroverse Themen werden ohne Zensur generiert.