Passer au contenu principal
Conservez le SDK Anthropic et l’appel Messages. Pointez le client vers https://api.phaseo.app, passez votre clé Phaseo comme authToken et donnez à chaque modèle son identifiant Phaseo.

Changer de client

Créez une clé dans Clés API, puis rendez-la disponible pour l’application sous le nom PHASEO_API_KEY.
Trois détails font le plus souvent échouer cette étape :
  • Utilisez l’hôte racine. baseURL: "https://api.phaseo.app/v1" produit /v1/v1/messages. Les clients compatibles OpenAI du même dépôt continuent d’utiliser /v1.
  • Envoyez la clé comme jeton bearer. La passerelle lit uniquement Authorization: Bearer ; un en-tête x-api-key reçoit 401 missing_or_invalid_authorization_header. authToken envoie Bearer avec toutes les versions du SDK. apiKey ne le fait qu’à partir de @anthropic-ai/sdk 1.0 et anthropic 2.0.
  • Supprimez ANTHROPIC_API_KEY des environnements qui appellent désormais Phaseo. apiKey: null empêche les anciens SDK TypeScript de la lire, et les SDK Python antérieurs à 0.98 la lisent même lorsque auth_token est défini.
Les outils configurés par variables d’environnement, comme Claude Code, utilisent ANTHROPIC_BASE_URL=https://api.phaseo.app, ANTHROPIC_AUTH_TOKEN défini sur la clé Phaseo et un ANTHROPIC_API_KEY vide.

Faire correspondre les identifiants de modèle

Vérifiez chaque modèle de production dans data[].id de GET /v1/models?format=openai. Les identifiants Phaseo utilisent des points dans la version : claude-sonnet-5-5 devient anthropic/claude-sonnet-5.5. Si le modèle change aussi, lisez le guide de migration de modèle correspondant.

Ce qui fonctionne différemment

Tester et déployer

Testez les prompts système, le streaming, l’utilisation d’outils, le raisonnement et les sorties structurées avec les identifiants de modèle exacts utilisés par l’application. Comparez ensuite un ensemble de prompts représentatifs entre les deux configurations : format de sortie, latence, utilisation des jetons, erreurs et coût. Avant de déplacer le trafic, vérifiez que :
  • la clé Phaseo est définie dans chaque environnement de déploiement ;
  • chaque identifiant de modèle de production figure dans GET /v1/models?format=openai ;
  • les flux de streaming et d’utilisation d’outils passent en préproduction ;
  • chaque en-tête anthropic-beta et chaque champ réservé aux bêtas a été supprimé ou remplacé ;
  • le retour arrière se limite toujours à un changement d’URL de base et de clé.
Dernière modification le 7 novembre 2026