Leçon 1 sur 4 · 6 minutes

Ce qu’est Phaseo

Phaseo est une passerelle : une seule API et une seule clé devant de nombreux modèles et les fournisseurs qui les hébergent.

Phaseo est une passerelle d’IA. Vous envoyez chaque requête à une seule API, https://api.phaseo.app/v1, avec une seule clé. Phaseo transmet chaque requête à un fournisseur capable de la traiter et la facture à votre espace de travail. Vous pouvez utiliser le format Responses, Chat Completions ou Messages, celui que votre application parle déjà.

Les modèles et les fournisseurs sont deux choses différentes. Un modèle est le système qui rédige la réponse. Un fournisseur héberge le modèle et en fixe le prix, la vitesse, la disponibilité et les paramètres pris en charge. Un même modèle peut avoir plusieurs fournisseurs.

Un ID de modèle désigne le modèle, pas le fournisseur. Les ID ressemblent à openai/gpt-6-astra ou anthropic/claude-sonnet-5.5 : le laboratoire, puis le modèle. phaseo/free choisit un modèle gratuit disponible et fonctionne sans crédits. Si vous avez besoin d’un fournisseur précis, vous pouvez le placer devant l’ID, par exemple baseten:thinking-machines/inkling-small.

Comment une requête est routée :

  1. Phaseo ne garde que les fournisseurs autorisés par les paramètres de votre espace de travail et par la requête.
  2. Il les classe. Le mode par défaut, balanced, pondère le prix, la vitesse et la fiabilité.
  3. Il appelle le premier fournisseur. Si celui-ci échoue, il essaie le suivant.
  4. Si tous les fournisseurs échouent avec une erreur relançable et que vous avez listé des modèles de repli dans models, il essaie le modèle suivant.

Les replis ne garantissent pas le succès : votre application doit toujours relancer les erreurs 429 et 5xx avec un délai croissant. Autre point : le catalogue public liste certains modèles qui ne sont pas encore appelables. Vérifiez qu’un modèle est Actif sur Gateway avant d’utiliser son ID.

Vérifiez votre compréhension

Vous appelez un modèle hébergé par trois fournisseurs, et le fournisseur classé premier renvoie une erreur. Que fait Phaseo ensuite ?

Mettez-le en pratique

Un collègue a trouvé un modèle sur la page Modèles de Phaseo et a copié son ID dans une requête. La requête échoue, mais la page du modèle semble normale. Quelle est la cause la plus probable, et comment la vérifier ?

Afficher la réponse

Le catalogue liste plus de modèles que le Gateway ne peut en appeler. Le modèle est peut-être Bientôt disponible ou Inactif. Sur la page Modèles, le filtre État Gateway affiche par défaut les modèles Actif sur Gateway, et GET /v1/models ne renvoie que les modèles que vous pouvez appeler. Choisissez un modèle Actif sur Gateway.

À retenir

Vous choisissez le modèle ; Phaseo choisit un fournisseur qui l’héberge et bascule vers un autre si l’un échoue.

Liens utiles

La progression est enregistrée dans ce navigateur.

Dernière vérification le 17 novembre 2026