Verständnis der Basis-URL
Die Base-URL definiert, wohin Ihr Client Anfragen sendet. Ein Fehler hier führt sofort zu Verbindungsfehlern oder unerwarteten Modellantworten. Viele Entwickler gehen fälschlicherweise davon aus, dass die Standard-OpenAI-URL universell funktioniert, aber unzensierte Anbieter verwenden oft eindeutige Endpunkte, um den Traffic an spezifische Modell-Pools zu leiten.
Stellen Sie sicher, dass Ihre Konfiguration auf https://api.openrouterabliteratedmodels.com/v1 für unseren Dienst. Wenn Sie einen Drittanbieter-Aggregator verwenden, stellen Sie sicher, dass die Basis-URL genau mit ihrer Dokumentation übereinstimmt. Falsche URLs führen oft zu 404-Fehlern oder Antworten von Standardmodellen anstelle der beabsichtigten zensurfreien Variante.
- Überprüfen Sie Ihre Umgebungsvariablen auf
BASE_URLoderAPI_HOST. - Stellen Sie sicher, dass der Pfad
/v1für Standardkompatibilität. - Testen Sie die Konnektivität mit einer einfachen Modelllistenanfrage, bevor Sie umfangreiche Anfragen senden.
Rate Limits handhaben
Ratenlimits beschränken, wie viele Anfragen Sie innerhalb eines bestimmten Zeitraums senden können. Unsere API erzwingt ein Limit von 300 Anfragen pro Minute pro Schlüssel. Das Überschreiten dieses Schwellenwerts führt zu HTTP-429-Fehlern, die weitere Anfragen vorübergehend blockieren, bis das Zeitfenster zurückgesetzt wird.
Es gibt eine Begrenzung für gleichzeitige Anfragen von 8 Anfragen gleichzeitig pro Schlüssel. Wenn Sie mehr als 8 gleichzeitige Anfragen senden, werden die überschüssigen Anfragen je nach Client-Bibliothek in die Warteschlange gestellt oder fehlschlagen. Überwachen Sie die Parallelität Ihrer Anwendung, um diese harten Grenzen nicht zu überschreiten. Verwenden Sie Strategien mit exponentiellem Backoff in Ihrem Code, um 429-Fehler graceful zu behandeln, ohne den Server zu spammen.
Denken Sie daran, dass jeder Schlüssel einzigartig für Ihr Konto ist. Das Teilen von Schlüsseln über mehrere Dienste hinweg kann dazu führen, dass diese Limits schneller erreicht werden. Generieren Sie einen neuen Schlüssel, wenn Sie separate Ratenlimit-Pools für verschiedene Teile Ihrer Anwendung benötigen.
Streaming- vs. Nicht-Streaming-Antworten
Streaming gibt Daten inkrementell zurück, während Tokens generiert werden, während nicht-streaming auf die vollständige Antwort wartet. Streaming ist für Echtzeit-Benutzererlebnisse unerlässlich, erfordert jedoch eine sorgfältige Verarbeitung von Server-Sent Events (SSE).
Beim Streaming enthält der letzte Chunk die Token-Nutzungsstatistiken. Wenn Sie die Verarbeitung vorzeitig stoppen, könnten Sie diese Daten verpassen. Stellen Sie sicher, dass Ihr Client die letzte SSE-Nachricht parst, um Input- und Output-Token-Anzahlen genau zu ermitteln. Nicht-Streaming-Antworten sind zwar einfacher, können aber bei langen Ausgaben zu hoher Latenz führen.
Wählen Sie Streaming für Chat-Schnittstellen, bei denen Benutzer sehen, wie Text Zeichen für Zeichen erscheint. Verwenden Sie Nicht-Streaming für die Stapelverarbeitung oder wenn Sie die vollständige Antwort benötigen, bevor Sie fortfahren. Unsere API unterstützt beide Modi über die stream Parameter im Anfragekörper.
JSON-Modus-Fehler
Der JSON-Modus stellt sicher, dass das Modell gültiges JSON ausgibt, was für die programmatische Integration kritisch ist. Fehler entstehen hier oft durch falsche Header oder Schema-Mismatches. Die API erfordert response_format: {"type": "json_object"} um strenge JSON-Ausgabe zu erzwingen.
Wenn Sie fehlerhaftes JSON erhalten, überprüfen Sie Ihre Schema-Definition. Das Modell könnte Markdown-Codeblöcke oder erläuternden Text außerhalb der JSON-Struktur enthalten. Verwenden Sie einen robusten Parser, der Markdown-Zäune entfernen oder die Ausgabe gegen Ihr erwartetes Schema validieren kann. Vermeiden Sie zu komplexe Schemata, die das Modell verwirren.
Testen Sie zunächst mit einfachen Strukturen. Fügen Sie schrittweise Komplexität hinzu, um zu identifizieren, wo das Modell Schwierigkeiten hat. Stellen Sie sicher, dass Ihre Temperatur angemessen eingestellt ist, da höhere Temperaturen die Zufälligkeit erhöhen und die JSON-Gültigkeit verringern können.
Fehlerhafte Token-Anzahlberechnungen
Token-Anzahlen bestimmen Ihre Abrechnung und die Nutzung des Context-Window. Falschberechnungen können zu unerwarteten Gebühren oder abgeschnittenen Antworten führen. Unsere API berechnet $0.15 pro 1M Input-Tokens und $0.50 pro 1M Output-Tokens.
Verwenden Sie eine zuverlässige Tokenizer-Bibliothek, die dem Tokenisierungsschema des Modells entspricht. Unterschiedliche Modelle tokenisieren Leerzeichen oder Interpunktion möglicherweise anders, was zu Diskrepanzen zwischen Ihrer lokalen Zählung und der API-Zählung führt. Verlassen Sie sich bei der genauen Abrechnung immer auf die im Antwort-Header zurückgegebenen Token-Nutzungsdaten.
Behalten Sie Ihren Context-Window im Auge, der insgesamt 100.000 Tokens umfasst. Das Überschreiten dieses Limits führt zu Fehlern. Kürzen Sie ältere Nachrichten oder Zusammenfassungen, um innerhalb der Grenzen zu bleiben. Überwachen Sie Ihre Token-Nutzung im Laufe der Zeit, um Ihre Prompt-Struktur zu optimieren und Kosten zu senken.
Verzögerungen bei Krypto-Zahlungen
Krypto-Aufladungen über USDT (TRC20) oder USDC (Base) werden auf unserer Seite sofort verarbeitet. Netzwerküberlastung kann jedoch gelegentlich zu leichten Verzögerungen bei der Bestätigung führen. Stellen Sie sicher, dass Sie den richtigen Betrag und das richtige Netzwerk senden, um Verluste zu vermeiden.
Top-ups reichen von $20 bis $500 in ganzen Beträgen. Bonusguthaben wird automatisch angewendet: +5 % ab $50, +10 % ab $100 und +15 % ab $200. Überprüfen Sie den Transaktionshash, um die Zahlung zu bestätigen. Wenn das Guthaben innerhalb weniger Minuten nicht erscheint, überprüfen Sie den Blockchain-Explorer für den Transaktionsstatus.
Guthaben verfällt nicht, sodass keine Eile besteht, es sofort zu verwenden. Fehler wie Doppelbuchungen werden über die Support-Seite gelöst. Bewahren Sie Ihre Transaktionsaufzeichnungen für den einfachen Zugriff bei Problemen auf.
Modell-ID-Konfiguration
Die Modell-ID identifiziert, welche Version des Uncensored-Modells Sie verwenden. Für unseren Dienst lautet die Modell-ID uncensored. Die Verwendung einer falschen ID kann zu Fehlern oder unerwartetem Verhalten führen.
Stellen Sie sicher, dass Ihre Requests model: "uncensored" im Anfragekörper. Diese ID verweist auf unser spezifisches Open-Weight-Modell, das für unzensierte Antworten optimiert ist. Es ist kein generischer Bezeichner, sondern ein spezifischer Verweis auf unsere gehostete Instanz.
Überprüfen Sie die Dokumentation Ihrer Client-Bibliothek, wie die Modell-ID festgelegt wird. Einige Bibliotheken verwenden ein model Feld, während andere möglicherweise einen anderen Parameter verwenden. Die Konsistenz bei der Verwendung der Modell-ID in Ihrer Anwendung verhindert Verwirrung und stellt sicher, dass Sie immer das beabsichtigte unzensierte Modell aufrufen.
Kontextfenster-Überschreitungen
Das Context-Window begrenzt die Gesamtzahl der Tokens, die Sie in einer einzelnen Anfrage senden können. Unsere API unterstützt ein Window mit 100.000 Tokens, einschließlich Eingabe und Ausgabe. Das Überschreiten dieses Limits führt zu einem Fehler.
Um den Kontext zu verwalten, implementieren Sie eine Gleitfenster-Strategie. Entfernen Sie ältere Nachrichten oder fassen Sie sie zusammen, um Speicherplatz freizugeben. Überwachen Sie die Token-Anzahl Ihrer Eingabe, um sicherzustellen, dass sie innerhalb des 100.000-Token-Limits bleibt. Wenn Sie das Limit überschreiten, lehnt die API die Anfrage ab.
Nutzen Sie die max_tokens Parameter zur Steuerung der Ausgabelänge. Die maximale Ausgabe pro Anfrage beträgt 16.000 Tokens. Die Einstellung dieses Parameters hilft, übermäßigen Tokenverbrauch zu verhindern und hält die Antworten in einem für Ihre Anwendung handhabbaren Rahmen.
Support- und Rückerstattungsrichtlinie
Guthaben wird nach dem Verbrauch nicht erstattet, verfällt aber auch nicht. Wenn Sie Probleme mit Zahlungen oder dem Service haben, kontaktieren Sie den Support über die dafür vorgesehene Seite. Fehler wie Doppelbelastungen werden vom Support-Team behoben.
Bei technischen Problemen prüfen Sie zunächst die Dokumentation. Unsere API ist übersichtlich, doch können Randfälle auftreten. Nennen Sie Ihren API-Schlüssel und die Details der Anfrage, wenn Sie Hilfe suchen. Die Antwortzeiten variieren, doch wir streben eine schnelle Lösung der Probleme an.
Denken Sie daran, dass das Guthaben im Voraus bezahlt wird. Sie zahlen nur für das, was Sie verbrauchen, wobei Fehler und Ablehnungen kostenlos sind. Dieses Modell gewährleistet Transparenz bei der Abrechnung. Nutzen Sie die Support-Seite bei Unstimmigkeiten oder Fragen zu Ihrem Konto.
