Zum Hauptinhalt springen
Tausche in AI-SDK-Code @ai-sdk/gateway gegen @phaseo/ai-sdk-provider aus und umschließe jede Modell-ID mit phaseo(...). Ändere in OpenAI-kompatiblen Clients die Basis-URL und den Schlüssel. Deine Generierungslogik bleibt gleich.

Provider umstellen

Der Standardexport phaseo liest PHASEO_API_KEY einmal beim Import des Moduls und verwendet https://api.phaseo.app/v1. Wird die Variable erst nach den Imports gesetzt, wie in manchen Serverless- und Test-Setups, wirft jeder Aufruf einen Fehler wegen fehlendem Schlüssel; rufe stattdessen createPhaseo({ apiKey, baseURL, headers }) innerhalb des Handlers auf. Installiere die Provider-Linie, die zu deiner ai-Hauptversion passt: @phaseo/ai-sdk-provider für AI SDK 7, @phaseo/ai-sdk-provider@ai-sdk-v6 für AI SDK 6 und @phaseo/ai-sdk-provider@ai-sdk-v5 für AI SDK 5. Das AI SDK schickt Modelle als einfache Strings (model: "openai/gpt-4.1-mini") standardmäßig über das Gateway von Vercel, ein zurückgelassener String ruft es also weiter auf. Ändere die gemeinsame Modell-Factory einmal und suche dann in AI-SDK-Aufrufen nach model: ". Anthropic-SDK-Clients, die auf ai-gateway.vercel.sh zeigen, wechseln zur Einrichtung aus Vom Anthropic-SDK migrieren.

Gateway-Optionen zuordnen

providerOptions.phaseo wird in den Anfrage-Body übernommen. Ein übrig gebliebenes providerOptions.gateway wird ohne Fehler ignoriert.

Testen und umstellen

Schicke denselben Prompt-Satz über beide Wege und vergleiche Latenz, Ausgabeformat und Tokennutzung. Bevor du Traffic hochstufst:
  • PHASEO_API_KEY ist in jeder Laufzeit gesetzt, die den Gateway-Schlüssel hatte, einschließlich Edge-, Server- und Preview-Deployments;
  • der Haupt-Textgenerierungspfad und ein Streaming-Test bestehen in Staging unverändert;
  • Tool-Aufrufe und strukturierte Ausgaben bestehen, falls die App sie nutzt;
  • die Fehlerzuordnung auf Anwendungsebene funktioniert weiterhin;
  • eine fehlgeschlagene Staging-Anfrage lässt sich finden und, wenn replay_supported true ist, über GET /v1/generations?id=<request_id> wiederholen.
Liefere hinter einem Feature-Flag oder einer prozentualen Umstellung aus, beginnend mit internem Traffic. Beobachte Latenz, Fehlerrate sowie Abweichungen bei Tokens und Kosten und halte den alten Provider mindestens ein Release lang verfügbar, damit das Zurückrollen keine Codeänderung braucht.
Mehr zum Provider findest du unter AI SDK.
Zuletzt geändert am 7. November 2026