Passer au contenu principal
Dans le code AI SDK, remplacez @ai-sdk/gateway par @phaseo/ai-sdk-provider et enveloppez chaque identifiant de modèle dans phaseo(...). Dans les clients compatibles OpenAI, changez l’URL de base et la clé. Votre logique de génération reste la même.

Changer de fournisseur

L’export phaseo par défaut lit PHASEO_API_KEY une seule fois, à l’importation du module, et utilise https://api.phaseo.app/v1. Si la variable est définie après les importations, comme dans certaines configurations serverless et de test, chaque appel lève une erreur de clé manquante ; appelez plutôt createPhaseo({ apiKey, baseURL, headers }) dans le gestionnaire. Installez la ligne du fournisseur qui correspond à votre version majeure de ai : @phaseo/ai-sdk-provider pour AI SDK 7, @phaseo/ai-sdk-provider@ai-sdk-v6 pour AI SDK 6 et @phaseo/ai-sdk-provider@ai-sdk-v5 pour AI SDK 5. Par défaut, l’AI SDK envoie les modèles sous forme de simple chaîne (model: "openai/gpt-4.1-mini") via la passerelle de Vercel ; une chaîne simple oubliée continue donc de l’appeler. Modifiez une fois la fabrique de modèles partagée, puis recherchez model: " dans les appels AI SDK. Les clients du SDK Anthropic pointés vers ai-gateway.vercel.sh passent à la configuration décrite dans Migrer depuis le SDK Anthropic.

Faire correspondre les options de la passerelle

providerOptions.phaseo est fusionné dans le corps de la requête. Un providerOptions.gateway oublié est ignoré sans erreur.

Tester et déployer

Exécutez le même ensemble de prompts par les deux chemins et comparez la latence, le format de sortie et l’utilisation des jetons. Avant de promouvoir le trafic, vérifiez que :
  • PHASEO_API_KEY est défini dans chaque environnement d’exécution qui avait la clé de la passerelle, y compris les déploiements edge, serveur et de prévisualisation ;
  • le chemin principal de génération de texte et un test en streaming passent sans modification en préproduction ;
  • les appels d’outils et les sorties structurées passent si l’application les utilise ;
  • la correspondance des erreurs au niveau de l’application fonctionne toujours ;
  • une requête de préproduction en échec peut être retrouvée et, lorsque replay_supported vaut true, relancée depuis GET /v1/generations?id=<request_id>.
Publiez derrière un feature flag ou un déploiement par pourcentage, en commençant par le trafic interne. Surveillez la latence, le taux d’erreur et la dérive des jetons et des coûts, et gardez l’ancien fournisseur disponible pendant au moins une publication pour que le retour arrière ne nécessite aucun changement de code.
Pour en savoir plus sur le fournisseur, consultez AI SDK.
Dernière modification le 7 novembre 2026