Von OpenRouter zu FlowModels.
OpenRouter spricht dasselbe Format, der Umstieg betrifft vor allem Basis-URL, Schlüssel, die Schreibweise der Modell-IDs und die Felder für Ausweichrouten.
Was sich ändert
Basis-URL, Schlüssel und Modellname. Alles Übrige bleibt, solange du keine Felder aus der Tabelle weiter unten benutzt.
| Stelle | Vorher | Bei FlowModels |
|---|---|---|
| Basis-URL | https://openrouter.ai/api/v1 |
https://api.flowmodels.one/v1 |
| Schlüssel | OPENROUTER_API_KEY |
FLOWMODELS_API_KEY |
| Modellname | google/gemini-3.7-flash |
gemini/gemini-3.7-flash |
Der Code davor und danach
client = OpenAI(
- base_url="https://openrouter.ai/api/v1",
- api_key=os.environ["OPENROUTER_API_KEY"],
+ base_url="https://api.flowmodels.one/v1",
+ api_key=os.environ["FLOWMODELS_API_KEY"],
)
response = client.chat.completions.create(
- model="google/gemini-3.7-flash",
+ model="gemini/gemini-3.7-flash",
messages=[{"role": "user", "content": "Hallo!"}],
- extra_headers={"HTTP-Referer": "https://example.com", "X-Title": "Mein Produkt"},
- extra_body={"models": ["openai/gpt-5-mini"], "provider": {"sort": "price"}},
)
Kein automatisches Failover.
FlowModels ruft genau das Modell auf, das du nennst. Bei 429 oder 503 des Anbieters wiederholt die API denselben Aufruf höchstens zweimal, danach bekommst du den Fehler mit seinem Code. Soll dein Dienst auf ein anderes Modell ausweichen, entscheidet das dein Code.
Felder, die sich anders verhalten
Maßgeblich ist, was das gewählte Modell kann. Welche Felder es annimmt, steht bei GET /v1/models unter supported_parameters.
| Feld | Verhalten bei FlowModels |
|---|---|
models, route, provider, transforms, plugins |
Diese OpenRouter-Felder wertet FlowModels nicht aus. Entferne sie, damit dein Code nicht von ihnen ausgeht. |
Modell-IDs |
Das Präfix ist der Anbieter dieser API: x-ai/… wird zu xai/…, google/… zu gemini/…, Versionen können anders geschrieben sein. Prüfe jede ID auf der Seite Modelle oder bei GET /v1/models. |
Suffixe wie :nitro oder :online |
Solche Modellnamen kennt der Katalog nicht, sie enden mit 404 model_not_found. Die Websuche schaltest du bei Modellen, die das können, mit web_search: true ein. |
reasoning |
Auf /v1/chat/completions heißt das Feld reasoning_effort, auf /v1/responses reasoning.effort. Welche Stufen ein Modell kennt, steht unter capabilities.reasoning_levels. |
usage |
Den Verbrauch bekommst du ohne weiteres Feld im Antworttext; beim Streaming mit stream_options.include_usage im letzten Ereignis. |
HTTP-Referer, X-Title |
Diese Header wertet FlowModels nicht aus. Du kannst sie entfernen. |
Das prüfst du nach dem Umstieg
-
Der neue Schlüssel steht in
FLOWMODELS_API_KEY, undGET /v1/modelsnennt dein Modell. -
Ein Aufruf ohne Streaming liefert wie erwartet
choices[0].message.content. -
Mit
stream: truekommen die Ereignisse an; mitstream_options.include_usagesteht der Verbrauch im letzten Ereignis. -
Werkzeugaufrufe und
response_formatlaufen mit genau dem Modell, das du einsetzt. -
Deine Fehlerbehandlung trennt
429 insufficient_quota(Guthaben leer) von429 rate_limit_exceeded,429 concurrent_requests_exceededund503 provider_overloaded. - Im Anfrageprotokoll deines Dashboards stehen Modell, Token und Kosten des Aufrufs.
-
Deine Anwendung reagiert selbst auf
502 routing_execution_failedund503 provider_overloaded, wenn sie ohne Ausweichroute weiterlaufen soll.