DE ▾
API-Schlüssel erhalten

Erste API-Anfrage und OpenAI SDK-Verbindung

Für den ersten Einsatz der unzensierten API benötigst du nur einen API-Schlüssel und musst die Base URL ändern. Wenn du bereits Code mit dem OpenAI SDK hast, reicht es, Adresse und Modellnamen anzupassen, um die erste Antwort zu erhalten.

Aktualisiert am

Isometrische Illustration eines OpenAI-kompatiblen Connectors im API-Gateway, durch den Daten fließen

Zusammenfassung

  • Die Base URL ist https://api.mugeomyeolapi.com/v1, die Modell-ID ist uncensored.
  • Unterstützt Endpunkte für chat/completions, responses, models sowie Streaming, Function Calling und JSON-Modus.
  • 429-Fehler werden in rate_limited und concurrency unterteilt, wobei die Reaktion je nach Ursache unterschiedlich ist.
  • Nur Text, keine Bild- oder Audioausgabe. Sexuelle Inhalte mit Minderjährigen sind in jedem Fall verboten.

Vorbereitung vor dem Start

Du benötigst drei Dinge: Schlüssel, Base URL und Modell-ID. Der Rest wird von deinem üblichen OpenAI-kompatiblen Client übernommen.

  1. Registriere dich. Du kannst dich mit deinem Google-Konto oder mit E-Mail und Passwort registrieren.
  2. Erstelle deinen Schlüssel auf der API-Schlüssel-Seite. Neue Nutzer erhalten hier mit einem Klick $0,50 kostenloses Testguthaben. Einmal pro Nutzer, 7 Tage gültig, keine Zahlungsmethode erforderlich.
  3. Gib die Base URL als https://api.mugeomyeolapi.com/v1 und das Modell als uncensored an.

Die Authentifizierung erfolgt über den Standard-Header Authorization: Bearer <Schlüssel>. Speichere den Schlüssel nicht direkt im Code, sondern in einer Umgebungsvariable. Die folgenden Beispiele lesen die Variable MUGEOMYEOL_API_KEY.

Erste Anfrage mit Python

Installiere das openai-Paket (v1+) und erstelle den Client. Ändere nur base_url.

import os
from openai import OpenAI

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

res = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "당신은 간결하게 답하는 한국어 어시스턴트입니다."},
        {"role": "user", "content": "HTTP 429 오류가 무엇인지 두 문장으로 설명해 줘."},
    ],
    temperature=0.7,
)
print(res.choices[0].message.content)
print(res.usage)

usage enthält Input- und Output-Token. Die Kosten basieren darauf. Den Restsaldo siehst du im Header X-Balance-USD. In Python SDK greifst du über with_raw_response zu.

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])
raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "안녕"}],
)
print("잔액(USD):", raw.headers.get("X-Balance-USD"))
completion = raw.parse()
print(completion.choices[0].message.content)

curl- und Node.js-Beispiele

Wenn du es ohne SDK testen möchtest, ist curl am schnellsten. Es ist nützlich, um zu prüfen, ob dein Schlüssel korrekt funktioniert.

curl https://api.mugeomyeolapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MUGEOMYEOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "한 줄로 자기소개해 줘."}]
  }'

Die Struktur ist auch in Node.js gleich.

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "짧은 시를 한 편 써 줘." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Streaming wird durch stream: true aktiviert und über SSE übertragen. Der Verbrauch kann am Ende des Streams eingesehen werden. Die Liste der verfügbaren Modelle wird mit GET /v1/models abgerufen. Da dieser Dienst nur das Modell uncensored anbietet, ist die Liste auch kurz.

Häufig verwendete Parameter

Die meisten Parameter aus OpenAI Chat Completions funktionieren weiterhin. Hier sind die wichtigsten im Überblick.

ParameterZweck
temperature, top_pSteuerung der Zufälligkeit der Antwort. Es ist einfacher, Ergebnisse vorherzusagen, wenn du nur einen Parameter anpasst, anstatt beide gleichzeitig stark zu ändern.
stop, seedStoppzeichen festlegen, Reproduzierbarkeit sicherstellen
Presence-/Frequency-PenaltyWiederholungen unterdrücken
max_tokensOptional. Wenn weggelassen, wird der Rest des Kontextfensters verwendet.
tools, tool_choiceFunction Calling. Das Ergebnis wird als role: "tool"-Nachricht zurückgegeben.
response_formatAktiviere den JSON-Modus mit {"type":"json_object"}.

Das Kontextfenster umfasst Prompt und Ausgabe zusammen bis zu 100.000 Token. Achte bei langen Dokumenten darauf, dass die Eingabe nicht den Großteil dieser Grenze ausmacht. Im JSON-Modus ist es stabiler, im Prompt anzugeben, dass mit JSON geantwortet werden soll.

import os, json
from openai import OpenAI

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

res = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "도시 3곳의 이름과 인구 규모 느낌을 JSON 객체로 줘. 키는 cities 하나."}],
)
data = json.loads(res.choices[0].message.content)
print(data)

Neben POST /v1/chat/completions gibt es auch den Endpunkt POST /v1/responses. Wenn du neuen Code schreibst und das Responses-Format nutzt, kannst du es einfach über dieselbe Base URL aufrufen. Die Details zu den Feldern findest du in der API-Dokumentation.

Fehlercodes und Wiederholungslogik

Der erste Fehler, dem du begegnen wirst, ist HTTP 429. Dieser Statuscode hat hier zwei verschiedene Bedeutungen.

  • rate_limited: Du hast das Limit für Anfragen pro Minute überschritten. Reguläre Schlüssel erlauben 300 Anfragen pro Minute, Test-Schlüssel 60.
  • concurrency: Zu viele gleichzeitige Anfragen werden verarbeitet. Reguläre Schlüssel unterstützen 8 parallele Anfragen, Test-Schlüssel 2.

Auch wenn der Server vorübergehend ausgelastet ist, tritt 429 auf. In diesem Fall wird der Header Retry-After: 5 mitgesendet. Sende die Anfrage nach 5 Sekunden einfach erneut. Denke daran, dass eine Streaming-Anfrage einen Slot für die gleichzeitige Verarbeitung belegt, bis der Stream abgeschlossen ist. Wenn du den Stream offen lässt und nicht schließt, überschreitest du das Limit für gleichzeitige Anfragen schnell.

import os, time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"], max_retries=0)

def ask(prompt, tries=5):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))  # 5초, 10초, 15초 ... 점점 늘려 기다림
    raise RuntimeError("재시도 한도를 넘었습니다")

print(ask("테스트 메시지"))

Wenn parallele Anfragen zum Problem werden, ist es besser, die Anzahl der gleichzeitigen Aufrufe über einen Semaphore auf der Aufruferseite zu begrenzen, statt zu versuchen, die Anfrage wiederholt abzuschicken. Mit den Antwort-Headern X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency kannst du die Limits deines aktuellen Schlüssels überprüfen. Der Anfragetext darf maximal 8 MB groß sein. Bei fehlgeschlagenen oder abgelehnten Anfragen wird nichts berechnet. Wenn du ein Problem meldest, gib bitte den Header X-Request-Id aus der Antwort an, damit das Support-Team die Ursache leichter finden kann.

Nutzungsregeln und bekannte Limits

Dieser Dienst ist eine API, die ein unabhängiger Anbieter betreibt und auf einem Open-Weight-Modell basiert, das darauf ausgelegt ist, Inhalte ohne Zurückweisung für legale erwachsene Nutzer bereitzustellen. Es ist keine offizielle API von Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google oder Anthropic und auch kein Router, der Anfragen an Modelle verschiedener Anbieter weiterleitet. Wenn du eine unzensierte AI-API auswählst, solltest du diesen Unterschied kennen, um Verwechslungen zwischen Dokumentation und tatsächlichem Verhalten zu vermeiden.

  • Sexuelle Inhalte, die Minderjährige betreffen, sind in jedem Fall nicht erlaubt. Dieses Limit lässt sich nicht aufheben.
  • Nur Text. Es werden keine Bild-, Audio- oder Videoerzeugung, Embeddings oder Fine-Tuning angeboten.
  • Deine eingegebenen Prompts werden nicht zum Training des Modells verwendet. Weitere Details findest du in der Datenschutzerklärung.

Das Fehlen von Zurückweisungen bedeutet nicht, dass keine Verantwortung übernommen wird. Der Anbieter der Dienstleistung muss die AGB und die einschlägigen Gesetze einhalten.

Kostenübersicht und Aufladung

Der Preis beträgt $0,15 pro 1 Mio. Prompt-Token und $0,50 pro 1 Mio. Output-Token, abgezogen vom Prepaid-Guthaben. Es gibt kein Abo, das Guthaben verfällt nie. Ein Request mit 2.000 Prompt-Token und 500 Output-Token kostet z. B. $0,0003 + $0,00025 = $0,00055. 1.000 Requests kosten $0,55.

Mit dem Testguthaben von $0,50 kannst du etwa 900 Anfragen dieses Umfangs testen. Eine Aufladung ist in ganzen Dollarbeträgen zwischen $20 und $500 möglich. Bei Aufladungen ab $50 erhältst du einen Bonus von 5 %, ab $100 von 10 % und ab $200 von 15 %. Als Zahlungsmittel werden USDT (TRC20) und USDC (Base) akzeptiert. Eine detaillierte Tabelle findest du auf der Preisseite.

Weitere Anleitungen

Häufig gestellte Fragen

Wie viel OpenAI SDK-Code muss ich ändern?

Du musst nur die Base URL, den API-Schlüssel und den Modellnamen ändern. Die Modell-ID ist uncensored, die Base URL ist https://api.mugeomyeolapi.com/v1.

Wie erhalte ich das Testguthaben?

Nach der Anmeldung erhältst du $0,50, indem du einmal auf die Schaltfläche auf der API-Schlüssel-Seite klickst. Pro Person einmalig, gültig für 7 Tage, keine Zahlungsinformationen erforderlich.

Ich erhalte einen 429-Fehler, was soll ich tun?

Prüfe zunächst, ob der Fehlercode rate_limited oder concurrency lautet. Ersteres bedeutet, dass das Limit für Anfragen pro Minute überschritten wurde, letzteres, dass das Limit für gleichzeitige Anfragen überschritten wurde. Wenn ein Retry-After-Header vorhanden ist, warte die angegebene Zeit ab und versuche es erneut.

Kann ich auch Bilder generieren?

Nein. Diese API ist nur für Text ausgelegt und unterstützt keine Bild-, Audio- oder Videoerzeugung sowie keine Embeddings.

Kann ich lange Dokumente auf einmal eingeben?

Du kannst bis zu 100.000 Token für Prompt und Ausgabe zusammen verwenden. Die maximale Größe des Anfragetextes beträgt 8 MB.

API-Schlüssel nur mit Anmeldung

Konto erstellen, Schlüssel kopieren, Base URL ändern. Das war's schon für die Konfiguration.

API-Schlüssel erhalten
API-Schlüssel erhalten