Wichtige Punkte
- Nutze Chat Completion, Quelle Custom (OpenAI-kompatibel), Endpunkt https://api.ornith.top/v1, Modell-ID uncensored.
- Teste den Schlüssel zuerst mit curl, damit du ein Schlüsselproblem von einer SillyTavern-Einstellung unterscheiden kannst.
- Stelle die Kontextgröße so ein, dass sie zu deinen Chats passt; das Modell unterstützt bis zu 100.000 Token.
- Gruppenchats können mehrere Anfragen gleichzeitig auslösen, was einen Test-Schlüssel auf 2 begrenzt.
Was du vor dem Start benötigst
Du brauchst drei Dinge: eine installierte SillyTavern-Instanz, einen API-Schlüssel und die Endpunkt-Details. SillyTavern ist eine selbst gehostete Chat-Oberfläche für Charakter- und Roleplay-Gespräche und kann mit jedem Dienst kommunizieren, der dem OpenAI-Chat-Format folgt. Diese Website bietet einen solchen Dienst für die legale Erwachsenen-Nutzung: Fiktion, Roleplay und Companion-Apps für Erwachsene. Sie produziert keinen sexuellen Inhalt mit Minderjährigen, und keine Einstellung ändert daran.
Sammle diese Werte:
- Basis-URL:
https://api.ornith.top/v1 - Modell-ID:
uncensored - API-Schlüssel: erstellt auf der API-Schlüssel-Seite nach der Anmeldung mit Google oder mit E-Mail und Passwort.
Neue Konten können mit einem Klick auf dieser Seite $0.50 kostenloses Testguthaben beanspruchen. Es wird keine Karte benötigt, es gilt pro Person und es gilt 7 Tage lang. Das reicht völlig zum Testen einer Charakterkarte, denn ein typischer Chat-Zug kostet nur einen Bruchteil eines Cents (die Rechnung steht weiter unten).
Teste den Schlüssel zuerst mit curl
Sende zuerst eine Anfrage aus einem Terminal, bevor du SillyTavern berührst. Wenn es funktioniert, ist jeder spätere Fehler eine Frontend-Einstellung; wenn es fehlschlägt, ist das Problem der Schlüssel oder das Netzwerk.
curl https://api.ornith.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one short sentence."}]
}'
Du solltest JSON mit einem choices-Array erhalten. Schau dir auch die Antwort-Header an: X-Balance-USD zeigt dein verbleibendes Guthaben, und X-Request-Id ist das, was du zitieren solltest, wenn du den Support kontaktierst. Du kannst die Modelle auch mit GET /v1/models auflisten:
curl https://api.ornith.top/v1/models \
-H "Authorization: Bearer $API_KEY"
Die Liste zeigt die Modell-ID, die in SillyTavern verwendet werden soll, nämlich uncensored.
SillyTavern Schritt für Schritt verbinden
- Öffne SillyTavern und klicke auf das Steckersymbol oben, um API-Verbindungen zu öffnen.
- Wähle im API-Dropdown Chat-Vervollständigung.
- Wähle im Chat Completion Source-Dropdown Custom (OpenAI-kompatibel).
- Gib in Benutzerdefinierter Endpunkt (Base URL)
https://api.ornith.top/v1ein. Beende bei/v1. Füge/chat/completionsnicht hinzu, da die Client-App diesen Pfad selbst anhängt. - Füge deinen Schlüssel in das Feld Custom API Key ein.
- Gib in Model ID
uncensoredein. - Drücke Connect. Ein grüner Status mit dem Modellnamen bedeutet, dass der Handshake funktioniert hat.
Die Menübeschriftungen ändern sich bei SillyTavern-Versionen etwas, also suche nach der gleichen Idee, wenn ein Name in deiner Version abweicht: eine benutzerdefinierte OpenAI-kompatible Quelle, ein Endpunkt-Feld, ein Schlüssel-Feld und ein Modell-Feld. Wenn Connect fehlschlägt, wiederhole den curl-Test. Ein Authentifizierungsfehler von curl bedeutet, dass der Schlüssel falsch ist; ein funktionierender curl mit einem fehlgeschlagenen Connect bedeutet normalerweise einen Tippfehler in der URL, wie z. B. ein fehlendes /v1 oder ein nachgestellter Pfad.
Sobald verbunden, öffne eine beliebige Charakterkarte und sende eine Nachricht. Wenn du eine Antwort siehst, funktioniert die Integration. Der Rest ist Feinabstimmung.
Einstellungen, die für Rollenspiele wichtig sind
Kontextgröße
Das Modell hat ein Kontextfenster mit 100.000 Token, das den Prompt und die Antwort zusammen zählt. In SillyTavern steuert der Schieberegler für die Kontextgröße, wie viel Verlauf, Charakterkarte und Lorebook-Text pro Zug gesendet werden. Größere Werte bedeuten, dass der Charakter sich mehr merkt und jede Anfrage mehr kostet, da du pro Zug für Input-Token zahlst. Ein guter Startwert ist ein moderater Wert wie 16.000 bis 32.000 Token, nur erhöhen, wenn deine Chats lang genug sind, um ihn zu benötigen. Die Einstellung für die Antwortlänge entspricht max_tokens, was auf dieser API optional ist; setze einen Wert, wenn du kürzere Antworten möchtest.
Streaming
Aktiviere Streaming in den Chat Completion-Einstellungen. Die API unterstützt SSE mit stream: true, sodass Text erscheint, während er generiert wird, und du eine schlechte Antwort frühzeitig stoppen kannst. Die Nutzung wird am Ende des Streams gemeldet.
Sampling
Temperature, top_p, Stop-Sequenzen, Seed sowie die Häufigkeits- und Präsenzstrafen werden an das Modell weitergegeben. Für kreatives Chat ist eine Temperatur von etwa 0,8 bis 1,0 bei einem top_p-Wert nahe 0,9 ein üblicher Startpunkt. Wenn Antworten abschweifen oder sich wiederholen, senke die Temperatur etwas und füge eine kleine Häufigkeitsstrafe hinzu. Ändere immer nur eine Einstellung, um ihre Wirkung zu sehen.
Dein System-Prompt und Karte
Das Modell ist darauf abgestimmt, ohne Inhaltsfilter zu antworten, daher hängt die Qualität der Szene von deinem Prompt und der Charakterkarte ab. Eine klare Rolle, Umgebung, Tonfall und ein paar Beispielzeilen Dialog bewirken mehr als jedes Sampling-Tweak. Wenn du für ein erwachsenes Publikum schreibst, halte die Umgebung altersmäßig explizit: Jeder Charakter sollte erwachsen sein.
Kosten pro Nachricht, ausgerechnet
Die Preise sind $0,15 pro 1M Eingabe-Token und $0,50 pro 1M Ausgabe-Token, aus Prepaid-Guthaben ohne Abonnement. Da SillyTavern die Karte und den Verlauf in jedem Zug erneut sendet, dominiert die Eingabe.
Angenommen, ein Chat-Zug sendet 6.000 Token Kontext und erhält 400 Token zurück:
- Eingabe: 6.000 bei $0,15 pro 1M sind $0,0009.
- Ausgabe: 400 bei $0,50 pro 1M sind $0,0002.
- Gesamt: $0,0011 pro Zug.
Eine 200-Zug-Sitzung kostet $0,22. Das $0,50 Testguthaben deckt etwa 450 solche Züge ab. Fehlgeschlagene oder verweigerte Anfragen werden nicht berechnet. Wenn du Guthaben auflädst, funktioniert jeder ganze Betrag von $20 bis $500, mit +5% ab $50, +10% ab $100 und +15% ab $200, mit Karte (Visa, Mastercard, Apple Pay, Google Pay) oder Krypto (USDT auf TRC20, USDC auf Base). Guthaben verfällt nie. Die Preisseite hat die Details.
Häufige Fehler beheben
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Verbindung schlägt sofort fehl | Falsche Basis-URL oder Schlüssel | Verwende https://api.ornith.top/v1 ohne nachgestelltem Pfad; wiederhole den curl-Test |
HTTP 429, Code rate_limited | Zu viele Anfragen pro Minute | Verlangsamen; Test-Schlüssel erlauben 60 pro Minute, Voll-Schlüssel 300 |
HTTP 429, Code concurrency | Zu viele Anfragen gleichzeitig | Warte, bis die laufende Antwort endet; Test-Schlüssel erlauben 2 gleichzeitig, Voll-Schlüssel 8 |
HTTP 429 mit Retry-After: 5 | Vorübergehende Überlastung | Warte 5 Sekunden und versuche es erneut |
| Anfrage zu groß | Request-Body über 8 MB | Senke die Kontextgröße oder kürze das Lorebook |
| Kontext zu lang | Prompt plus Antwort über 100.000 Token | Senke Kontextgröße oder Antwortlänge |
Ein Detail fängt Leute in Gruppenchats und mit Features, die zusätzliche Hintergrundaufrufe ausführen: Eine gestreamte Anfrage hält ihren Concurrency-Slot, bis der Stream endet. Wenn SillyTavern eine Antwort, eine Zusammenfassung und eine Bildbeschriftung gleichzeitig auslöst, wird ein Test-Schlüssel mit 2 Slots den dritten ablehnen. Ein voller Schlüssel erlaubt 8. Deaktiviere die Extras, die du nicht brauchst, oder räume sie zeitlich auseinander.
Für alle Parameter und die genauen Fehlerformen lies die API-Dokumentation.
