# Was ändert sich bei der Migration von OpenRouter-Requests zu einer anderen OpenAI-kompatiblen API? > Das Ändern von Basis-URL und API-Schlüssel ist nur der erste Schritt. Standard-Chatfelder sind oft portabel, aber Modell-IDs, OpenRouter-Header und Routing-Erweiterungen, Fallbacks, Streaming, Kostenrechnung, multimodale Eingaben, Fehler und Limits müssen hinter einem Adapter getestet werden. # Was ändert sich bei der Migration von OpenRouter-Requests zu einer anderen OpenAI-kompatiblen API? Bei einfachem Chat kann die Migration mit neuer Basis-URL, neuem Schlüssel und neuer Modell-ID beginnen. In Produktion benötigen OpenRouter-Routing, Header, Slugs, Fallbacks, Metadaten und Provider-Auswahl Ersatz; Streaming und Tools brauchen Vertragstests. OpenAI-Kompatibilität ist ein gemeinsamer Transportdialekt und kein Versprechen identischer Kataloge, Erweiterungen, Abrechnung oder Betriebsweise. ## Den tatsächlich genutzten Vertrag inventarisieren Suchen Sie in Code, Konfiguration und Logs jedes an OpenRouter gesendete Feld. Die dokumentierte Einrichtung nutzt `https://openrouter.ai/api/v1`, Bearer-Authentifizierung und optionale Attribution-Header sowie gegebenenfalls Routing-Erweiterungen. Erstellen Sie vor Änderungen diese Liste: | Oberfläche | Oft portabel | Zu prüfen | |---|---|---| | Chat | `messages`, temperature, Ausgabelimit | Nicht unterstützte Parameter und Defaults | | Modelle | App-Absicht | Provider-spezifischer Slug | | Tools | Name und JSON schema | Parallelität, strict, Argument-Streaming | | Routing | Keines | Präferenzen, Fallbacks, transforms | | Header | Autorisierung | OpenRouter-Attribution und Metadaten | | Nutzung | Tokenzahlen | Kosten, Cache, Request-Abfrage | | Betrieb | HTTP-Familien | Limits, Wiederholung, Zeit, Fehlerkörper | ## Zuerst einen Provider-Adapter einführen Verteilen Sie URL und Slugs nicht im Code. Kapseln Sie Unterschiede und stellen Sie App-Aliase bereit. ```python from openai import OpenAI def make_client(base_url: str, api_key: str) -> OpenAI: return OpenAI(base_url=base_url, api_key=api_key) MODEL_MAP = { "coding_default": { "openrouter": "provider/model-slug", "target": "target-model-id", } } ``` Der Adapter übersetzt zusätzliche Felder, normalisiert Fehler und erzeugt gemeinsame Ereignisse. ## Modell- und Routing-Semantik ersetzen Modell-IDs sind nicht standardisiert. Ordnen Sie jeden App-Alias dem Zielmodell zu und prüfen Sie Kontext, Tools, strukturierte Ausgabe, Modalitäten und Preis im aktuellen Katalog. Das Ziel kann Routing und Fallbacks anders ausdrücken oder nicht anbieten. Entscheiden Sie, ob Sie sie in der Orchestrierung nachbauen, das Ziel-Routing nutzen oder bewusst entfernen. Stille Änderungen beeinflussen Kosten und Qualität. ## OpenRouter-Erweiterungen entfernen oder übersetzen Prüfen Sie spezielle Header und Body-Felder. Optionale Attribution-Header können meist entfallen; Provider-Präferenzen, Fallback-Listen, plugins, transforms und Metadatenkontrollen benötigen explizites Mapping. Lehnen Sie in Migrationstests unbekannte Erweiterungen ab. Stilles Ignorieren verschleiert Verhaltensänderungen. ## Tools und Streaming als Vertrag testen Testen Sie: * Annahme von Funktionsname und JSON schema; * Tool-Choice-Modi und parallele Aufrufe; * inkrementelle Tool-Argumente; * Abschlussgründe und Ablehnungen; * fehlerhafte Argumente und Wiederholung. Vergleichen Sie geparste Ereignisfolgen statt roher Chunks. Berücksichtigen Sie Abbruch, Fehler im Stream, finale Nutzung, leere Deltas und Wiederverbindung. ## Nutzungs- und Kostenrechnung neu aufbauen OpenRouter dokumentiert Metadaten mit Modell, Provider, Token und Gesamtkosten. Das Ziel kann Nutzung in der Antwort liefern, separat abfragbar machen oder Client-Berechnung verlangen. Normalisieren Sie in Ihr Ledger: ```json { "request_id": "internal_123", "provider_request_id": "external_456", "gateway": "target", "model": "resolved-model-id", "input_tokens": 1200, "output_tokens": 340, "cost_usd": 0.0123 } ``` Trennen Sie Schätzungen und abgestimmte Kosten. Prüfen Sie Budgetlimits vor der Migration produktiver Agenten erneut. ## Multimodale Request-Formen prüfen Bild, Audio und Video hängen von Modell und Endpoint ab. Zwei Gateways können sich bei Content-Parts, Upload, URL-Zugriff, asynchronen Jobs und Ausgaben unterscheiden. Erstellen Sie Fixtures für jede genutzte Modalität. Ein erfolgreicher Textchat beweist keine Medienkompatibilität. ## Betriebsverhalten testen Messen Sie Limit-Header, wiederholbare Statuscodes, Timeouts, Warteschlangen, Regionen, Idempotenz, Logs und Support. Nutzen Sie die aktuelle Dokumentation des Ziels. Ein praktischer Rollout hat vier Stufen: 1. Golden Requests offline abspielen. 2. Sicheren Traffic ohne Nutzerwirkung spiegeln. 3. Einen kleinen risikoarmen Canary ausführen. 4. Nur erweitern, wenn Fehler, Latenz, Kosten und Assertions innerhalb der Grenzen bleiben. Behalten Sie einfachen Rollback bis zur Prüfung repräsentativer Last. ## Entscheiden, ob Konsolidierung lohnt OpenRouter bleibt passend, wenn breiter LLM-Katalog und Routing zum Produkt passen. Atlas Cloud kann attraktiv sein, wenn ein OpenAI-kompatibler Zugang für Text, Bild und Video den Stack vereinfacht. Beide Vorteile ersetzen keine Tests. Entscheiden Sie nach gemessenen Anforderungen, nicht nach dem kleinsten Diff. ## Fazit Ändern Sie die Client-Konfiguration und prüfen Sie danach jede nicht standardisierte Annahme zu Modellen, Routing, Tools, Streaming, Nutzung und Betrieb. Ein Adapter mit Golden Tests hält die Migration umkehrbar und verhindert, dass syntaktischer Erfolg eine semantische Regression verbirgt. ## FAQ ### Kann man nur base_url und api_key ändern? Bei einfachem Chat manchmal, doch Produktionsintegrationen hängen oft auch von Modell-Slugs, Routing-Optionen, Headern, Streaming, Nutzungsfeldern oder Fallback-Semantik ab. ### Welche OpenRouter-Felder sind am wenigsten portabel? Provider-Präferenzen, Fallback-Listen, Attribution-Header, transforms, plugins und spezielle Metadaten sind typische Punkte. Halten Sie sie außerhalb des zentralen Request-Modells. ### Nutzen OpenAI-kompatible APIs dieselben Modellnamen? Nein. Kompatibilität betrifft meist die Request-Form, nicht die Katalogidentität. Ordnen Sie App-Aliase explizit aktuellen Modell-IDs jedes Gateways zu. ### Wie testet man Streaming nach der Migration? Protokollieren Sie Ereignisfolgen für Text-Deltas, Tool-Argumente, Abschlussgründe, Nutzung, Abbruch und Fehler. Vergleichen Sie geparste Ereignisse statt roher Byte-Blöcke. ### Was ist der sicherste Rollout? Nutzen Sie einen Adapter, spielen Sie ein Golden Set ab, führen Sie eine kleine Shadow-Stichprobe aus und danach einen risikoarmen Canary mit Rollback-Grenzen für Fehler, Latenz, Kosten und Assertions. ### Wann sollte ein Team bei OpenRouter bleiben? Wenn der breite LLM-Katalog, Routing-Kontrollen und vorhandene Betriebswerkzeuge wertvoller sind als eine Konsolidierung anderswo. Entscheiden Sie nach gemessenen Anforderungen, nicht nur nach Kompatibilitätsversprechen.