DE ▾
nofilterai.top
NoFilter AI
API-Schlüssel erhalten

No-Filter-Rollenspiel-App: Erstelle eine mit einer API

Eine AI-Girlfriend-API bietet eine dedizierte Schnittstelle für Chat-Anwendungen, die romantische oder begleitende Interaktionen mit großen Sprachmodellen simulieren. Dieser Leitfaden vergleicht technische Ansätze, wobei der Fokus auf unzensierten Modellen liegt, die Roleplay-Kontext ohne Standard-Inhaltsablehnungen verarbeiten.

Eine Miniaturbühne, verbunden durch einen leuchtenden Datenstrom mit einem Server, die die Architektur einer Rollenspiel-App veranschaulicht

Die Architektur in einem Bild

Der Browser sendet die Nachricht des Nutzers an deinen Server. Dein Server fügt die Persona und den bisherigen Verlauf hinzu, ruft das Modell mit stream: true auf und leitet jedes Datenpaket weiter. Mehr ist nicht nötig.

  1. Browser: ein Textfeld und ein div, das wächst, wenn Token eintreffen.
  2. Dein Server: hält den API-Schlüssel, erstellt die Nachrichtenliste und erzwingt deine eigenen pro-Nutzer-Limits.
  3. Modell-API: POST /v1/chat/completions unter https://api.nofilterai.top/v1 mit Modell uncensored.
  4. Speicher: eine Tabelle oder Datei mit Nachrichten pro Konversation. SQLite reicht für den Anfang.

Das Modell ist ein Open-Weight-Modell, das darauf trainiert wurde, ohne Inhaltsfilter für die rechtmäßige Nutzung durch Erwachsene zu antworten. Es ist textbasiert. Wenn du Charakterkunst oder Stimme möchtest, füge selbst einen weiteren Dienst hinzu.

Entwerfe den System-Prompt

Für Rollenspiel übernimmt der System-Prompt die meiste Arbeit. Teile ihn in drei kurze Blöcke auf, damit du jeden unabhängig austauschen kannst: die Welt, die Figur und die Regeln des Formats.

{
  "world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
  "character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
  "format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}

Füge sie zur Anfragezeit zu einer einzigen Systemnachricht zusammen. Wenn du sie getrennt lässt, können Nutzer eine Welt und eine Figur unabhängig voneinander auswählen, was die meisten Anforderungen einer Roleplay-App erfüllt. Da erwachsene fiktionale Inhalte für die rechtmäßige Nutzung durch Erwachsene erlaubt sind, erwähne dies einmal in deinen eigenen Nutzungsbedingungen und füge eine Altersprüfung hinzu. Das einzige, was die API nicht produzieren wird, sind sexuelle Inhalte, die Minderjährige betreffen, und deine App sollte es nicht versuchen.

Das Streaming-Backend

Dieser Express-Route akzeptiert eine Konversations-ID und eine Nachricht, lädt den Verlauf und leitet den Stream als Server-Sent Events an den Browser weiter. Er verwendet das offizielle openai-Paket.

import express from "express";
import OpenAI from "openai";

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

const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages

app.post("/chat", async (req, res) => {
  const { id, text, persona } = req.body;
  const history = store.get(id) ?? [];
  history.push({ role: "user", content: text });

  res.setHeader("Content-Type", "text/event-stream");
  res.setHeader("Cache-Control", "no-cache");

  const stream = await client.chat.completions.create({
    model: "uncensored",
    messages: [{ role: "system", content: persona }, ...trim(history)],
    stream: true,
    temperature: 0.9,
  });

  let reply = "";
  for await (const chunk of stream) {
    const piece = chunk.choices[0]?.delta?.content ?? "";
    if (piece) {
      reply += piece;
      res.write("data: " + JSON.stringify(piece) + "\n\n");
    }
  }
  history.push({ role: "assistant", content: reply });
  store.set(id, history);
  res.write("data: [DONE]\n\n");
  res.end();
});

app.listen(3000);

Der letzte Chunk eines Streams enthält Nutzungsdaten, die du protokollieren kannst, um zu sehen, was jede Konversation kostet. In der Produktion ersetze die Map durch eine Datenbank und füge Fehlerbehandlungen um den Aufruf hinzu.

Verlauf im 100k-Fenster kürzen

Das Kontextfenster umfasst 100.000 Token für Prompt und Completion. Roleplay-Sessions wachsen langsam, aber sie wachsen. Eine Trim-Funktion, die nach Größe arbeitet, vermeidet Überraschungen. Eine grobe Schätzung von 4 Zeichen pro Token ist für die Budgetplanung ausreichend.

function trim(history, maxChars = 120000) {
  let total = 0;
  const kept = [];
  for (let i = history.length - 1; i >= 0; i--) {
    total += history[i].content.length;
    if (total > maxChars) break;
    kept.unshift(history[i]);
  }
  return kept;
}

120.000 Zeichen sind etwa 30.000 Token, weit unter dem Limit, und halten jeden Aufruf günstig. Erhöhe es nur, wenn deine Geschichte eine lange Erinnerung benötigt. Beachte die Kostenregel: Jeder Schritt sendet den gespeicherten Verlauf als Input mit $0,15 pro 1 Mio. Token zurück, also kostet ein Prompt mit 30.000 Token 30.000 / 1.000.000 x $0,15 = $0,0045 pro Schritt vor der Antwort.

Der Browser-Client

Die Seite liest den SSE-Stream mit fetch und hängt Text an, sobald er eintrifft. Da die Anfrage ein POST ist, passt EventSource nicht, also analysiere den Stream manuell.

async function send(text) {
  const out = document.getElementById("reply");
  out.textContent = "";
  const r = await fetch("/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
  });
  const reader = r.body.getReader();
  const dec = new TextDecoder();
  let buf = "";
  while (true) {
    const { value, done } = await reader.read();
    if (done) break;
    buf += dec.decode(value, { stream: true });
    const parts = buf.split("\n\n");
    buf = parts.pop();
    for (const p of parts) {
      if (p === "data: [DONE]") break;
      if (p.startsWith("data: ")) {
        out.textContent += JSON.parse(p.slice(6));
      }
    }
  }
}

Funktionen, die es wie eine App wirken lassen

  • Erneut generieren und bearbeiten. Behalte Nachrichten-IDs. Erneut generieren bedeutet, die letzte Assistenten-Nachricht zu löschen und die API erneut mit demselben Verlauf aufzurufen. Bearbeiten bedeutet, eine gespeicherte Nachricht vor dem nächsten Aufruf umzuschreiben.
  • Pro-Figur-Einstellungen. Speichere temperature, top_p und Strafwerte mit jeder Figur. Ruhigere Figuren mögen 0,7, chaotische Figuren mögen 1,0. Übergebe seed, wenn du reproduzierbare Testläufe möchtest.
  • Kostenanzeige. Lese den X-Balance-USD-Antwortheader oder rufe GET /v1/balance auf und zeige dem Nutzer, wie viel Guthaben noch übrig ist. Wenn du Zugang an deine eigenen Nutzer weiterverkaufst, spart dir das viele Support-Fragen.
  • Deine eigenen Sicherheitsvorkehrungen. Füge eine Altersprüfung für Erwachsene, eine Melde-Schaltfläche und eine Regel hinzu, die jede Anfrage mit Minderjährigen blockiert, bevor sie die API erreicht. Die Plattform erzwingt dieses Limit ebenfalls, aber deine App sollte es auch tun.

Grenzen, Fehler und Budgets

Ein vollständiger Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Eine gestreamte Anfrage belegt einen Concurrency-Slot, bis der Stream endet, also wird eine Roleplay-App mit 20 aktiven Nutzern in Stoßzeiten die Grenze erreichen. Die API antwortet mit HTTP 429 und dem Code concurrency oder rate_limited, und bei temporärer Überlastung fügt sie Retry-After: 5 hinzu. Stelle Anfragen auf deinem Server in eine Warteschlange und wiederhole sie nach dieser Verzögerung.

Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also kosten Wiederholungen dich nichts. Zur Budgetplanung kostet ein typischer Schritt mit 3.000 Input-Token und 300 Output-Token $0,00045 + $0,00015 = $0,0006. Guthaben wird ab $20 vorausbezahlt und verfällt nie. Diese Website akzeptiert Krypto, USDT auf TRC20 oder USDC auf Base; die Preisseite listet die Boni ab $50 auf.

Nächste Schritte

Hole einen Schlüssel und teste mit dem kostenlosen Testguthaben: Die API-Schlüssel-Seite bietet $0,50 Guthaben nach der Anmeldung, gültig für 7 Tage, ohne Zahlungsdaten. Der Test-Schlüssel erlaubt 2 parallele Anfragen, genug für einen Single-User-Prototypen. Die Dokumentation listet jeden Parameter auf, einschließlich Function Calling, wenn du Würfelergebnisse oder Inventar als Function Calls behandeln möchtest.

Für eine Variante im Begleiter-Stil mit einer einzelnen persistenten Figur sieh dir den KI-Begleiter-API-Artikel an. Für einen Chatbot auf einem Server lies die Discord-Bot-Anleitung.

Fragen und Antworten

Kann ich die API direkt vom Browser aus aufrufen?

Das geht, aber dann gibst du deinen Schlüssel an jeden Besucher preis. Halte den Schlüssel auf einem Server und mache nur deine eigene Route verfügbar.

Wie verhindere ich, dass das Modell die Aktionen meiner Figur schreibt?

Definiere es im System-Prompt und füge bei einem Transkript-Format eine Stop-Sequenz hinzu. Beides funktioniert mit den Durchreichungsparametern.

Muss die App Konversationen speichern?

Die API selbst ist zustandslos, also sendest du den Verlauf bei jedem Schritt erneut. Prompts werden nicht zum Training verwendet.

Was ist die günstigste Methode zum Prototyping?

Verwende den Test-Schlüssel und eine Map im Speicher. Wechsle zu einer Datenbank und einem bezahlten Schlüssel, sobald die Schleife funktioniert.

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