mit der falschen base_url
Die Verwendung der Standard-OpenAI-Basis-URL führt dazu, dass Ihre Anfragen fehlschlagen oder zu einem anderen Modell weitergeleitet werden. Unsere API erfordert, dass Sie die base_url zu https://api.whatisopenrouterai.com/v1. Diese einzelne Konfigurationszeile stellt sicher, dass Ihr SDK mit unseren Servern statt mit der globalen OpenAI-Infrastruktur verbunden wird.
Viele Entwickler kopieren und fügen ihren bestehenden Code ein, ohne diese Variable zu aktualisieren. Wenn Sie die Standard-URL beibehalten, erhalten Sie entweder einen 404-Fehler oder treffen auf ein Modell, das nicht uncensored ist. Überprüfen Sie die Verbindung immer, indem Sie die /v1/models Endpunkt. Du solltest dort unsere spezifische Modell-ID aufgelistet sehen. Dies bestätigt, dass das Routing korrekt ist, bevor du deine erste Completion-Anfrage sendest.
das Vergessen, die Modell-ID
Auch bei korrekter Basis-URL führt das Auslassen der Modell-ID zu einem generischen oder älteren Modell. Sie müssen explizit die model Parameter auf "uncensored" in jeder Anfrage. Dies teilt unserer Routing-Schicht mit, das spezifische Open-Weight-Modell für unzensierte Inhalte auszuliefern.
Ohne diese explizite Anweisung erhalten Sie möglicherweise ein anderes Modell mit anderen Ausrichtungsregeln. Einige Modelle lehnen legale erwachsene Themen standardmäßig ab. Durch das Erzwingen der uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
Ignorieren von Token-Limits und Fehlern
Das Überschreiten des Kontextfensters von 100.000 Token oder des Ausgabe-Limits von 16.000 Token führt zu sofortigen Anfragefehlern. Unsere API erzwingt ein maximales Ausgabevolumen von 16.000 Token pro Anfrage. Wenn Sie nicht max_tokens, der Standardwert beträgt nur 2.048 Tokens. Dies ist oft zu kurz für komplexe Reasoning-Aufgaben.
Fehler und Ablehnungen verbrauchen nicht Ihr prepaid-Guthaben. Allerdings zählen fehlerhafte Anfragen, die Rate-Limits treffen oder die Körpergröße überschreiten (8 MB), immer noch gegen Ihr Kontingent. Überwachen Sie Ihre Antwort-Header für Token-Nutzung. Passen Sie Ihre Prompt-Engineering an, um innerhalb des Kontextfensters zu passen. Dies verhindert kostspielige Wiederholungen und gewährleistet einen reibungslosen Datenfluss.
Missverständnis der vorausbezahlten Abrechnung
Ihr Kontostand ist an Prepaid-Guthaben gebunden, nicht an ein monatliches Abonnement. Wir berechnen $0,15 pro 1M Input-Tokens und $0,50 pro 1M Output-Tokens. Fehler sind kostenlos, aber erfolgreiche Vervollständigungen verbrauchen Guthaben. Sie müssen über Kryptowährungen aufladen, um die Dienstverfügbarkeit aufrechtzuerhalten.
Wir akzeptieren USDT (TRC20) oder USDC (Base) für Aufladungen. Mindesteinzahlungen beginnen bei $20. Boni gelten in höheren Stufen: +5% ab $50, +10% ab $100 und +15% ab $200. Guthaben verfällt nie. Stellen Sie sicher, dass Ihr Guthaben positiv ist, bevor Sie große Batches ausführen. Prüfen Sie das Dashboard, um Ihr aktuelles Guthaben und die letzten Transaktionen zu überprüfen.
Streaming mit Standardantworten verwechseln
Streaming über SSE ändert die Art und Weise, wie Sie den Antwortstream parsen. Standardantworten geben ein einzelnes JSON-Objekt zurück. Streaming gibt mehrere Chunks zurück. Sie müssen den letzten Chunk verarbeiten, um genaue Token-Nutzungsstatistiken zu erhalten.
Unsere Streaming-Implementierung enthält die Token-Nutzung im letzten Chunk. Wenn Sie den Stream vorzeitig beenden, gehen diese Daten möglicherweise verloren. Stellen Sie sicher, dass Ihre Client-Bibliothek SSE korrekt unterstützt. Dies ist entscheidend für Echtzeitanwendungen, in denen Tokens während der Generierung angezeigt werden. Fehlkonfiguriertes Streaming kann zu unvollständigem Text oder fehlerhaften UI-Zuständen führen.
tool_choice-Konfigurationsfehler
Falsch tool_choice Einstellungen können dazu führen, dass die Funktionsaufrufe nicht wie beabsichtigt funktionieren. Sie können ein bestimmtes Tool erzwingen oder das Modell entscheiden lassen. Eine Fehlkonfiguration führt häufig dazu, dass das Modell verfügbare Funktionen ignoriert.
Verwenden tool_choice zur Steuerung, ob das Modell Tools automatisch aufruft. Setzen Sie es auf "auto" für Flexibilität oder geben Sie eine Tool-ID für strenges Verhalten an. Stellen Sie sicher, dass Ihre Funktionsdefinitionen dem erwarteten Schema entsprechen. Dies vermeidet Laufzeitfehler, wenn das Modell versucht, eine nicht vorhandene Funktion aufzurufen. Testen Sie Ihre Tool-Definitionen gründlich, bevor Sie in die Produktion gehen.
fehlender json_object-Modus
Ohne response_format: {"type": "json_object"}, das Modell kann Markdown oder Klartext ausgeben. Dies bricht Parser, die strenges JSON erwarten. Aktivieren Sie den JSON-Modus, um eine konsistente, parsebare Ausgabe zu gewährleisten.
Diese Funktion ist essenziell für die Integration mit nachgelagerten Systemen, die strukturierte Daten erfordern. Sie reduziert den Nachbearbeitungsaufwand erheblich. Validieren Sie das Ausgabeschema immer in Ihrem Client-Code. Dies gewährleistet Robustheit gegenüber gelegentlichen Modellhalluzinationen. Verwenden Sie diesen Modus beim Extrahieren von Entitäten oder Generieren von Konfigurationsdateien.
Rate-Limit-Überraschungen
Unsere API erlaubt 300 Anfragen pro Minute pro Schlüssel. Das Überschreiten dieses Limits führt zu einer 429 Too Many Errors-Antwort. Gleichzeitige Anfragen sind auf 8 pro Schlüssel begrenzt. Planen Sie Ihre Parallelitätseinstellungen entsprechend.
Wenn Sie mehrere Prozesse ausführen, stellen Sie sicher, dass sie denselben Schlüssel verwenden oder generieren Sie separate Schlüssel. Jedes Konto unterstützt einen aktiven Schlüssel. Ein neuer Schlüssel ersetzt den alten. Überwachen Sie Ihre Ratenlimit-Header in der Antwort. Implementieren Sie Exponential Backoff in Ihrer Retry-Logik. Dies verhindert Kaskadenfehler während Phasen hoher Auslastung.
Verzögerungen bei Krypto-Aufladungen
Krypto-Transaktionen benötigen Zeit für die Bestätigung in der Blockchain. Ihr Guthaben erscheint möglicherweise nicht sofort nach dem Senden der Mittel. Verwenden Sie das richtige Netzwerk: TRC20 für USDT oder Base für USDC. Das Senden an das falsche Netzwerk führt zum Verlust der Mittel.
Aufladungen erfolgen in ganzen Beträgen von $20 bis $500. Stellen Sie sicher, dass Sie den exakten Betrag senden oder Netzwerkgebühren berücksichtigen. Prüfen Sie den Transaktionshash im Blockchain-Explorer. Wenn das Guthaben verzögert gutgeschrieben wird, kontaktieren Sie den Support mit der Transaktions-ID. Gehen Sie nicht davon aus, dass die Zahlung sofort fehlgeschlagen ist. Geduld bei Netzwerküberlastung ist der Schlüssel für einen reibungslosen Ablauf.
