Vercel AI Gateway statt Provider-SDKs
Ein API-Key, alle Modelle, Provider-Wechsel ohne Code-Diff — was wir beim Bau des Chat-Widgets dieser Website gelernt haben.
Im Sommer 2025 hatten wir in einem einzigen Repo drei AI-SDKs parallel laufen: @ai-sdk/openai, @ai-sdk/anthropic und einen selbstgebauten Wrapper für ein lokales Modell. Heute steht da nur noch eine Zeile: import {'{'} gateway {'}'} from "@ai-sdk/gateway". Hier ist warum.
Was das Problem war
Drei Provider-SDKs in einem Codebase ist nicht „nur drei Dependencies". Es ist:
- Drei Auth-Mechanismen — drei Env-Vars, drei verschiedene Rate-Limit-Header, drei verschiedene Fehler-Schemata.
- Drei Token-Counter — OpenAI, Anthropic und das lokale Modell zählen unterschiedlich. Pricing-Vergleich „pro 1k Token" ist deshalb meistens eine Lüge.
- Drei Streaming-APIs — der eine liefert SSE, der andere chunked-JSON, der dritte einen WebSocket. Wir hatten drei verschiedene Streaming-Adapter im Frontend, jeder mit eigenen Bugs.
- Drei Vendor-Lock-In-Punkte — Provider-Wechsel war kein „API-Key tauschen", sondern „eine Woche Refactor".
Das fühlte sich Monate lang nach „so ist das halt in AI-Land" an. War es nicht.
Wie der Gateway das löst
Vercel AI Gateway (GA seit August 2025) ist ein einziger Endpoint, hinter dem alle bekannten Provider hängen. Sie geben "openai/gpt-5" oder "anthropic/claude-4-7-sonnet" als String an, der Gateway weiß, was zu tun ist. Provider-Wechsel ist eine String-Änderung.
Konkret im Code:
// vorher
import OpenAI from "openai";
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const resp = await openai.responses.create({ model: "gpt-5", input: prompt });
// nachher
import {'{'} streamText {'}'} from "ai";
import {'{'} gateway {'}'} from "@ai-sdk/gateway";
const resp = await streamText({'{'} model: gateway("openai/gpt-5"), messages: [...] {'}'});
Provider wechseln? gateway("anthropic/claude-4-7-sonnet"). Fertig. Kein Auth, kein neuer SDK, kein Streaming-Adapter.
Die fünf Sachen, die uns überrascht haben
1. Ein API-Key für alle Provider
Statt OPENAI_API_KEY, ANTHROPIC_API_KEY, GROQ_API_KEY etc. nur AI_GATEWAY_API_KEY (oder auf Vercel: gar nichts — OIDC-Token-basiert). Bei mehreren Projekten nebeneinander heißt das: keine vierfach gerollte Key-Rotation mehr.
2. Zero Data Retention überall, ein Vertrag
ZDR vertraglich mit dem Gateway statt mit jedem einzelnen Provider zu verhandeln. Für DACH-Mittelstand ein riesiger Unterschied — der Datenschutz-Beauftragte einer Praxis will nicht drei AVVs lesen, sondern einen.
3. Model-Fallback ist eingebaut
Wenn OpenAI grad rate-limited oder kurz down ist, kann der Gateway auf Anthropic ausweichen — pro Request, ohne dass wir was im Code ändern müssen. Wir haben das via maxSteps und einer kleinen onError-Handler-Config aufgesetzt. Seit dem Umbau im Q1 2026 ist auf dieser Website kein Ausfall des Chats mehr sichtbar geworden.
4. Observability gratis
Vercel-Dashboard zeigt pro Model: Token-Verbrauch, Latency-P50/P95, Fehler-Rate, Kosten. Vorher hatten wir das in einem selbst gebauten LangSmith-Setup, was eine Woche Arbeit war. Mit dem Gateway ist es Default — nichts zu konfigurieren.
5. Plain-String-Models sind die richtige Default-Abstraktion
Wenn der Gateway sich entscheidet, dass "openai/gpt-5" jetzt intern auf "openai/gpt-5.1" routet (z.B. neueres Modell, gleicher Preis), läuft unser Code weiter — wir bemerken's nicht mal. Wenn wir explizit pinnen wollen, schreiben wir "openai/gpt-5-2026-01-15". Beides ist Code-Konfiguration, kein Library-Refactor.
Was wir trotzdem im Auge behalten
- Provider-spezifische Features (z.B. Anthropic Tool-Use vs. OpenAI Function-Calling) sind via Gateway auf das gemeinsame Subset reduziert. Wenn Sie absichtlich ein Provider-only-Feature einsetzen wollen (z.B. OpenAI Realtime API), brauchen Sie weiterhin das Provider-SDK direkt.
- Latency-Overhead ist minimal aber existiert — bei extrem latency-sensitiven Edge-Cases (Live-Voice-Calls) prüfen.
- Pricing-Aufschlag beim Gateway selbst ist in den meisten Plans bereits inkludiert, aber prüfen Sie Ihren Plan.
Was Sie daraus mitnehmen
Wenn Sie in Ihrem Projekt mehr als ein AI-Provider-SDK installiert haben, fragen Sie sich, warum. In 90% der Fälle gibt es dafür keinen guten Grund — nur historische Pfadabhängigkeit. Vercel AI Gateway (oder das equivalente Konzept anderer Plattformen) reduziert Code-Komplexität, Vertrags-Komplexität und Vendor-Lock-In gleichzeitig.
Wenn Ihr AI-Code mehr Provider-SDK-Imports hat als Ihre Auth-Datei: Gateway.
Fachbeiträge per E-Mail
Wie technische Entscheidungen zustande kommen — unregelmäßig und nur dann, wenn es etwas zu berichten gibt. Jederzeit abbestellbar. Sie erhalten zuerst eine Mail mit Bestätigungslink.
Hilft das Ihrem Vorhaben weiter?
Sprechen wir 30 Minuten darüber — konkret zu Ihrem Vorhaben.
Auch lesenswert
Wie wir aus einem Chat-Widget einen Conversion-Funnel gemacht haben
Ein Floating-Chat-Widget allein konvertiert nicht. Das mussten wir lernen — und sechs Pattern nachbauen, damit aus klick-scroll-schließ ein messbarer Funnel von Open bis Erstgespräch wurde.
DSGVO bei AI — was das in der Praxis wirklich bedeutet
DSGVO ist bei AI weniger Endgegner als oft behauptet — aber es lebt in den Details. Fünf konkrete Fragen, die Sie beantworten müssen, bevor ein Modell Ihre Kund:innen-Daten sieht.
Ohne Zwischenstationen. Sie sprechen direkt mit der Geschäftsleitung.
Wir hören Ihnen 30 Minuten zu, stellen ein paar gezielte Fragen und sagen Ihnen am Ende offen, ob — und wie — wir Ihnen helfen können. Wenn nicht, erhalten Sie mindestens zwei Empfehlungen, wer es könnte.
- 30 Minuten, ohne Verkaufsgespräch
- Konkrete Einschätzung Ihres Vorhabens
- Klare Einordnung, welcher Projektrahmen passt