Konto erstellen
Nur für Unternehmen und Selbstständige

Menü

Alle Anleitungen

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, und GET /v1/models nennt dein Modell.
  • Ein Aufruf ohne Streaming liefert wie erwartet choices[0].message.content.
  • Mit stream: true kommen die Ereignisse an; mit stream_options.include_usage steht der Verbrauch im letzten Ereignis.
  • Werkzeugaufrufe und response_format laufen mit genau dem Modell, das du einsetzt.
  • Deine Fehlerbehandlung trennt 429 insufficient_quota (Guthaben leer) von 429 rate_limit_exceeded, 429 concurrent_requests_exceeded und 503 provider_overloaded.
  • Im Anfrageprotokoll deines Dashboards stehen Modell, Token und Kosten des Aufrufs.
  • Deine Anwendung reagiert selbst auf 502 routing_execution_failed und 503 provider_overloaded, wenn sie ohne Ausweichroute weiterlaufen soll.

Schlüssel erstellen, Modell nennen, loslegen.

FlowModels richtet sich ausschließlich an Unternehmen und Selbstständige.