DE ▾
API-Schlüssel erhalten

So nutzt du OpenRouter in Janitor AI: Proxy-Einrichtung

Hier erfährst du, wie du OpenRouter in Janitor AI verwendest und wie du auf die gleiche Weise einen anderen OpenAI-kompatiblen Endpunkt einbindest. Janitor AI ermöglicht es dir, einen Chat auf einen externen Proxy zu richten, sodass jeder Server, der das OpenAI-Format für Chat-Vervollständigungen unterstützt, die Antworten liefern kann.

Abbildung einer Chat-Blase, die über eine Proxy-Relaisverbindung mit einem API-Server-Turm verbunden ist

Aktualisiert

Wichtige Punkte

  • Die API-Einstellungen von Janitor AI akzeptieren eine Proxy-URL, einen Schlüssel und einen Modellnamen, was genau das ist, was ein OpenAI-kompatibler Dienst benötigt.
  • Verwende für diese API https://api.openrouternsfw.com/v1, deinen Schlüssel und den Modellnamen uncensored.
  • Einige Versionen benötigen die vollständige Chat-Vervollständigungs-URL; teste sie mit curl, um zu wissen, welche Form funktioniert.
  • Eine Rollenspiel-Nachricht mit langer Historie kostet etwa $0,00135, also rund $1,35 pro 1.000 Nachrichten.

Keine Karte nötig. Nach der Anmeldung beanspruche mit einem Klick 0,50 $ kostenloses Testguthaben (einmal pro Person).

API-Schlüssel erhalten

So funktioniert die Verbindung

Janitor AI ist eine Chat-Seite für Charaktere. Neben den integrierten Optionen kannst du über eine API-Einstellung dein eigenes Modell einbinden. Diese Einstellung fragt drei Dinge ab: eine Endpunkt-URL, einen Schlüssel und einen Modellnamen. OpenRouter passt hier, da es einen OpenAI-kompatiblen Endpunkt bereitstellt; seine Modellnamen folgen dem Format Anbieter/Modell und dein Schlüssel stammt aus deinem OpenRouter-Konto.

Die gleichen drei Felder funktionieren mit jedem anderen OpenAI-kompatiblen Dienst. Die API dieser Seite ist einer: Basis-URL https://api.openrouternsfw.com/v1, ein Bearer-Schlüssel und die Modell-ID uncensored. Die folgenden Schritte decken also beide Fälle ab. Wenn sich ein Schritt zwischen den beiden unterscheidet, weise ich darauf hin.

Janitor AI ist eine Drittanbieter-Seite und ihre Menüs ändern sich. Ich beschreibe die Einstellungen so, wie sie üblicherweise angeordnet sind, also erwarte, dass die Bezeichnungen leicht abweichen. Die Werte sind das, was zählt.

Bereite die drei Werte vor

Bevor du Janitor AI öffnest, sammle diese Daten.

FeldOpenRouterDiese API
EndpunktDie OpenAI-ähnliche URL von OpenRouter aus deren Dokumentationhttps://api.openrouternsfw.com/v1/chat/completions
SchlüsselSchlüssel aus deinem OpenRouter-KontoSchlüssel von der API-Schlüssel-Seite
ModellnameEine Anbieter/Modell-ID aus deren Listeuncensored

Auf der Schlüssel-Seite dieser API können neue Nutzer auch mit einem Klick $0,50 Testguthaben beanspruchen, jeweils pro Person, gültig für 7 Tage. Die Anmeldung erfolgt mit Google oder mit E-Mail und Passwort. Das Testguthaben reicht aus, um die gesamte Einrichtung zu testen, bevor du Guthaben auflädst.

Teste den Endpunkt zuerst mit curl

Janitor AI gibt dir wenig Feedback, wenn ein Proxy fehlschlägt; du siehst normalerweise einen allgemeinen Fehler im Chat. Prüfe den Endpunkt außerhalb der Seite, damit du weißt, dass die Werte korrekt sind, bevor du sie einfügst.

curl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

Eine JSON-Antwort mit einem choices-Array bedeutet, dass Schlüssel, URL und Modellname korrekt sind. Schau dir die Antwort-Header an, wenn du mehr wissen willst: X-Balance-USD zeigt das verbleibende Guthaben, und X-Request-Id ist nützlich, falls du den Support kontaktierst.

Gib den Proxy in Janitor AI ein

  1. Öffne einen Chat mit einem beliebigen Charakter.
  2. Öffne das Menü im Chat und wähle die API- oder Generierungseinstellungen. Der genaue Name variiert je nach Version.
  3. Wähle die Proxy-Option, also die für einen benutzerdefinierten OpenAI-kompatiblen Endpunkt, anstelle des integrierten Modells.
  4. Füge die Endpunkt-URL in das Proxy-URL-Feld ein.
  5. Füge den Schlüssel in das Schlüsselfeld ein.
  6. Gib den Modellnamen exakt so ein, wie angegeben: uncensored für diese API.
  7. Speichere die Einstellungen und lade die Chat-Seite neu.

Die Frage, welche URL-Form du nutzen sollst, ist der Punkt, an dem viele scheitern. Janitor AI's Proxy-Feld erwartet meist die vollständige Chat Completions-URL, die mit /chat/completions endet. Andere Tools erwarten nur die Basis-URL, die mit /v1 endet, und fügen den Pfad selbst hinzu. Wenn die vollständige URL einen Fehler liefert, versuche die Basis-URL und umgekehrt. Der curl-Test oben zeigt, dass die vollständige URL selbst gültig ist, also deutet ein Fehler darauf hin, wie die Seite ihre Anfrage aufbaut, nicht auf den Schlüssel.

Modellnamen sind groß-/kleinschreibungssensibel und müssen übereinstimmen. Ein falscher Modellname ist die zweithäufigste Ursache für eine fehlgeschlagene erste Nachricht.

Einstellungen, die für Rollenspiele wichtig sind

Janitor AI bietet einige Generierungseinstellungen neben den Proxy-Feldern an. Die API übergibt Sampling-Parameter, sodass sie eine Wirkung haben.

  • Temperatur: 0,7 bis 1,0 hält den Dialog lebendig. Höhere Werte führen zu Abweichungen und erfinden Details, die der Charakterkarte widersprechen.
  • Maximale Token: steuert die Antwortlänge. Ein Wert von 300 bis 600 eignet sich für Chat. Die Vervollständigung könnte den Rest des 100.000-Token-Fensters nutzen, aber so lange Chat-Antworten sind selten das, was du willst.
  • Kontextgröße: Die API akzeptiert bis zu 100.000 Token, Prompt plus Completion. Ein kleinerer Wert wie 8.000 hält die Kosten pro Nachricht niedrig und speichert dennoch viel Verlauf. Erhöhe ihn nur, wenn der Charakter Dinge vergisst, die du brauchst.
  • Wiederholungskontrolle: Wenn ein Charakter in denselben Phrasen verharrt, hilft ein moderater Frequenz- oder Präsenz-Strafwert. Beide werden durchgereicht.

Das Modell ist darauf abgestimmt, ohne Inhaltsablehnungen für die rechtmäßige Erwachsenen-Nutzung zu antworten, daher sollte eine für eine Erwachsenengeschichte geschriebene Charakterkarte keinen Ablehnungstext auslösen. Eine Regel ist fest: Sexuelle Inhalte mit Minderjährigen sind nicht erlaubt, und du solltest keinen Kartentext schreiben, der dies andeutet.

Was es kostet

Die Preise liegen bei $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token. Beim Rollenspiel entfällt fast die gesamte Kosten auf Input, da jede Nachricht die Charakterkarte und den Chat-Verlauf erneut sendet.

Nimm eine Nachricht mit 8.000 Token an Kontext und einer 300-Token-Antwort:

  • Input: 8.000 x $0,15 / 1M = $0,0012
  • Output: 300 x $0,50 / 1M = $0,00015
  • Gesamt: $0,00135 pro Nachricht oder $1,35 pro 1.000 Nachrichten

Eine Aufladung über 20 $ bezahlt etwa 14.800 Nachrichten bei dieser Größe (20 $ / 0,00135 $ sind 14.814). Das Testguthaben über 0,50 $ deckt etwa 370 Nachrichten ab. Wenn du den Kontext auf 30.000 Token erhöhst, steigen die Eingabekosten allein auf 0,0045 $ und eine Nachricht kostet 0,00465 $ bei gleicher Antwort, also nutze große Kontexte nur, wenn du sie brauchst.

Aufladungen starten bei 20 $ bis 500 $ mit Boni von 5 % ab 50 $, 10 % ab 100 $ und 15 % ab 200 $. Die Zahlung erfolgt in Krypto (USDT auf TRC20 oder USDC auf Base), das Guthaben verfällt nie, und fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet. Details findest du auf der Preisseite.

Fehlerbehebung

Netzwerkfehler oder keine Antwort

Prüfe das URL-Format (voller Pfad oder Basis). Prüfe, ob im Schlüsselfeld kein Leerzeichen am Ende steht. Führe dann den curl-Test erneut von deiner Maschine aus.

HTTP 401

Der Schlüssel ist falsch oder wurde mit zusätzlichen Zeichen eingefügt. Generiere ihn erneut von der Schlüsselseite.

HTTP 429

Lies den Fehlercode. rate_limited bedeutet mehr als die erlaubten Anfragen pro Minute (300 für einen Vollschlüssel, 60 für einen Trial-Schlüssel). concurrency bedeutet zu viele gleichzeitig (8 für einen Vollschlüssel, 2 für einen Trial-Schlüssel); in Janitor AI tritt dies auf, wenn du eine Antwort neu generierst, während die vorherige noch im Streaming ist, weil eine gestreamte Anfrage ihren Slot bis zum Ende belegt. Eine 429 mit Retry-After: 5 bedeutet temporäre Überlastung, also warte fünf Sekunden und versuche es erneut.

Antworten werden abgeschnitten oder schweifen ab

Passe max_tokens und temperature an. Wenn der Charakter aktuelle Ereignisse vergisst, erhöhe die Kontextgröße etwas.

Guthaben ist aufgebraucht

Der Header X-Balance-USD zeigt den verbleibenden Betrag. Füge Guthaben über das Dashboard hinzu; die Dokumentation behandelt das Fehlerformat vollständig.

OpenRouter oder diese API für Janitor AI

Sie sind unterschiedliche Dienstleistungen. OpenRouter ist ein Router, der viele Modelle von vielen Anbietern anbietet; du wählst das Modell nach Name, und was jedes Modell schreiben wird oder nicht, hängt von diesem Modell ab. Prüfe die aktuelle Modellliste und die Preise auf deren eigener Website. Diese API bietet ein einzelnes Open-Weight-Textmodell, betrieben von einem unabhängigen Anbieter und darauf abgestimmt, ohne Inhaltsablehnungen für die rechtmäßige Erwachsenen-Nutzung zu antworten. Es ist keine offizielle API eines Modellherstellers.

Wenn du Abwechslung möchtest, behalte deine OpenRouter-Einrichtung. Wenn deine Charaktere Ablehnungen erfahren und du ein stabiles, günstiges Einzelmodell möchtest, ist dieses einfach zu versuchen: Melde dich an, beanspruche das Testguthaben und füge die drei Werte oben ein. Prompts werden nicht zum Training verwendet.

Fragen und Antworten

Was gebe ich in die Proxy-Felder von Janitor AI ein?

Die Endpunkt-URL, dein API-Schlüssel und der Modellname. Für diese API sind das https://api.openrouternsfw.com/v1/chat/completions, dein Schlüssel und uncensored. Falls es fehlschlägt, versuche die Basis-URL, die auf /v1 endet.

Ist das dasselbe wie OpenRouter?

Nein. OpenRouter leitet zwischen vielen Modellen und Anbietern weiter. Dies ist ein Open-Weight-Modell eines unabhängigen Anbieters mit eigenem Schlüssel und Prepaid-Guthaben.

Warum erhalte ich einen 429-Fehler?

Entweder hast du das Ratenlimit pro Minute überschritten, du hast zu viele Anfragen, die gleichzeitig laufen, oder der Dienst ist kurzzeitig überlastet. Der Fehlercode und der Retry-After-Header sagen dir, welcher Fall vorliegt.

Kann ich es testen, ohne zu bezahlen?

Ja. Neue Nutzer können nach der Anmeldung mit einem Klick $0,50 kostenloses Testguthaben beanspruchen. Es ist 7 Tage lang gültig, jeweils eine pro Person.

Werden meine Chats zum Training verwendet?

Nein. Prompts, die an diese API gesendet werden, werden nicht zum Training verwendet.

Dein Schlüssel ist nur einen Schritt entfernt

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

API-Schlüssel erhalten