# Wat verandert er wanneer je OpenRouter-aanvragen migreert naar een andere OpenAI-compatibele API? > Een andere base URL en API-sleutel zijn slechts het begin bij vertrek van OpenRouter. Standaard chatvelden zijn vaak overdraagbaar, maar model-ID's, OpenRouter-headers en routeringsextensies, fallbacks, streaming, gebruiksboekhouding, multimodale invoer, fouten en rate limits moeten via een provideradapter worden getest. # Wat verandert er wanneer je OpenRouter-aanvragen migreert naar een andere OpenAI-compatibele API? Voor een eenvoudige chat completion begint migratie mogelijk met een nieuwe base URL, API-sleutel en model-ID. Productiegedrag omvat meer dan de aanvraagvorm. OpenRouter-specifieke routering, headers, modelslugs, fallbacks, metadata en providerselectie vereisen bewuste vervanging; streaming en tool calls vragen contracttests. Zie OpenAI-compatibiliteit als een gedeeld transportdialect, niet als garantie dat catalogi, extensies, facturering of operationeel gedrag gelijk zijn. ## Inventariseer het contract dat je echt gebruikt Zoek in code, configuratie en logs naar elk veld dat naar OpenRouter gaat. De gedocumenteerde OpenAI SDK-configuratie gebruikt `https://openrouter.ai/api/v1`, bearer-authenticatie en optionele attributieheaders. Applicaties kunnen ook routerings- en fallbackextensies gebruiken. Maak eerst een inventaris: | Oppervlak | Vaak overdraagbaar | Meestal controleren | |---|---|---| | Chataanvraag | `messages`, temperatuur, uitvoerlimiet | Niet-ondersteunde parameters en defaults | | Modellen | Applicatie-intentie | Providerspecifieke modelslug | | Tools | Functienaam en JSON-schema | Parallelle calls, strictness, argumentstreaming | | Routering | Geen | Providervoorkeuren, fallbacks, transforms | | Headers | Autorisatiepatroon | OpenRouter-attributie en metadataheaders | | Gebruik | Tokenaantallen | Kostenvelden, cachevelden, request lookup | | Operations | HTTP-statusfamilies | Rate limits, retries, time-outs, foutteksten | ## Introduceer eerst een provideradapter Verspreid de nieuwe URL en modelslug niet door de codebase. Plaats providerverschillen achter één adapter en bied applicatie-aliassen aan. ```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", } } ``` De adapter moet optionele velden vertalen, fouten normaliseren en een gedeeld gebeurtenisschema uitsturen. ## Vervang model- en routeringssemantiek Model-ID's zijn niet gestandaardiseerd door OpenAI-compatibiliteit. Koppel elke applicatie-alias aan een doelmodel en controleer contextlengte, toolondersteuning, gestructureerde uitvoer, modaliteiten en prijzen in de actuele catalogus. OpenRouter ondersteunt routering en fallbacks die een andere gateway anders of niet aanbiedt. Kies of je dit in de orchestratielaag nabouwt, de router van het doel gebruikt of bewust verwijdert. Stille fallbackwijzigingen kunnen kosten en kwaliteit veranderen. ## Verwijder of vertaal OpenRouter-extensies Controleer OpenRouter-specifieke headers en bodyvelden. Optionele attributieheaders kunnen bij vertrek meestal weg. Providervoorkeuren, fallback-arrays, plugins, transforms en metadatacontroles vragen expliciete mapping. Weiger onbekende extensies tijdens migratietests. Stil een veld negeren laat een aanvraag succesvol lijken terwijl het gedrag verandert. ## Test tools en streaming als contract Tool calling is een veelvoorkomende afwijking tussen schijnbaar compatibele API's. Test: * acceptatie van functienaam en JSON-schema; * tool-choice-modi en parallelle calls; * incrementele toolargument-events; * finish reasons en refusal-velden; * ongeldige argumenten en retries. Vergelijk voor streaming geparseerde eventreeksen, niet ruwe chunks. Neem annulering, fouten halverwege, eindgebruik, lege delta's en verbindingsretries mee. ## Bouw gebruiks- en kostenboekhouding opnieuw op OpenRouter documenteert generation metadata met onder andere model, provider, tokengebruik en totale kosten. Een andere gateway kan gebruik in de completion geven, een aparte lookup bieden of client-side prijzen vereisen. Normaliseer alles in je eigen grootboek: ```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 } ``` Houd schattingen en afgestemde kosten apart. Test budgetafdwinging opnieuw voordat productieagents verhuizen. ## Controleer multimodale aanvraagvormen Beeld-, audio- en videoondersteuning hangt af van model en endpoint. Twee gateways kunnen dezelfde modaliteit ondersteunen maar verschillen in content-part-schema's, uploads, URL-toegang, asynchrone jobs of uitvoerobjecten. Bouw fixtures voor elke gebruikte modaliteit. Leid mediacompatibiliteit niet af uit een geslaagde tekstaanvraag. ## Test operationeel gedrag Meet rate-limit-headers, retrybare statuscodes, time-outs, wachtrijen, regionale controles, idempotency, logging en supportprocedures. Gebruik actuele providerdocumentatie. Een praktische uitrol heeft vier poorten: 1. Speel een gouden aanvraagset offline opnieuw af. 2. Shadow veilig verkeer zonder zichtbare gevolgen. 3. Canary een klein percentage met laag risico. 4. Schaal alleen op zolang fouten, latency, kosten en uitvoerasserties binnen de drempels blijven. Behoud een rollback met één schakelaar totdat het nieuwe pad representatieve belasting aankan. ## Bepaal of consolidatie de moeite waard is OpenRouter past goed wanneer de brede LLM-catalogus en routeringscontrole bij het product passen. Een full-modal gateway zoals Atlas Cloud kan aantrekkelijk zijn wanneer één OpenAI-compatibele relatie voor tekst, beeld en video de stack vereenvoudigt. Beide keuzes vereisen model- en featuretests. Kies op basis van gemeten workloadeisen, niet de kleinste codediff. ## Conclusie Wijzig bij migratie van OpenRouter eerst de clientconfiguratie en audit daarna alle niet-standaard aannames rond modellen, routering, tools, streaming, gebruik en operations. Een provideradapter met gouden tests houdt de migratie omkeerbaar en voorkomt verborgen semantische regressie. ## FAQ ### Kan ik migreren van OpenRouter door alleen base_url en api_key te wijzigen? Soms bij een eenvoudige chataanvraag, maar productie-integraties hangen vaak af van modelslugs, routeringsopties, headers, streaminggedrag, gebruiksvelden of fallbacksemantiek die ook moeten veranderen. ### Welke OpenRouter-velden zijn waarschijnlijk niet overdraagbaar? Voorkeuren voor providerroutering, fallback-arrays, OpenRouter-attributieheaders, transforms, plugins en OpenRouter-specifieke metadata zijn veelvoorkomende migratiepunten. Houd ze buiten het kernmodel van je aanvraag. ### Gebruiken OpenAI-compatibele API's dezelfde modelnamen? Nee. Compatibiliteit betreft meestal de aanvraagvorm, niet de catalogusidentiteit. Maak een expliciete mapping van applicatie-aliassen naar de actuele model-ID's van elke gateway. ### Hoe test ik streaming na de migratie? Leg gebeurtenisreeksen vast voor tekstdelta's, toolargumenten, finish reasons, gebruik, annulering en fouten. Vergelijk geparseerde events in plaats van ruwe bytes, omdat framing kan verschillen. ### Wat is de veiligste migratieaanpak? Gebruik een adapter, speel een gouden aanvraagset opnieuw af, shadow een kleine steekproef zonder zichtbare gevolgen en voer daarna een canary uit met rollbackdrempels voor fouten, latency, kosten en uitvoerasserties. ### Wanneer moet een team OpenRouter blijven gebruiken? Blijf wanneer de brede LLM-catalogus, routeringsmogelijkheden en bestaande operationele tooling meer waarde bieden dan consolidatie elders. Baseer migratie op gemeten eisen, niet alleen op compatibiliteitsclaims.