Passer au contenu principal
Ajoutez un déploiement dédié ou auto-hébergé à votre espace de travail : votre équipe l’appelle via l’API Phaseo habituelle avec un identifiant de modèle tel que acme/legal-assistant. Seul votre espace de travail peut le voir ou l’appeler, et il fonctionne partout où un identifiant de modèle public fonctionne.
Les modèles privés sont en Bêta. Les propriétaires et les administrateurs de l’espace de travail les ajoutent et les gèrent.
Les sources typiques sont les déploiements dédiés sur Baseten, Modal, RunPod, Fireworks ou Together, et les serveurs exécutant vLLM ou un autre serveur compatible OpenAI.

Avant de commencer

Votre déploiement doit fournir :
  • une URL de base HTTPS publique ;
  • un endpoint /chat/completions compatible OpenAI ;
  • une authentification par jeton Bearer ; et
  • un identifiant de modèle ou de déploiement amont accepté par cet endpoint.
La prise en charge de /responses est facultative. Laissez-la désactivée, sauf si le déploiement implémente explicitement cet endpoint.
Les modèles privés n’adaptent pas les protocoles propres à un fournisseur ni les schémas d’authentification personnalisés. Placez une couche compatible OpenAI devant ces déploiements ou utilisez une intégration de fournisseur prise en charge par Phaseo.

Connecter un déploiement

1

Ouvrir Modèles privés

Ouvrez Tableau de bord → Paramètres → Espace de travail → Modèles privés, puis sélectionnez Ajouter un modèle. Vous devez être propriétaire ou administrateur de l’espace de travail. Pour l’automatiser, appelez POST /v1/private-models avec les mêmes champs et une clé de gestion.
2

Nommer le modèle

Choisissez un modèle existant du catalogue pour ajouter ce déploiement à sa liste de fournisseurs, ou saisissez un slug de modèle court tel que legal-assistant. Si aucun modèle du catalogue n’a ce slug unique, Phaseo le combine avec l’espace de noms de confiance de l’espace de travail :
Vous ne pouvez ni choisir ni remplacer l’espace de noms de l’espace de travail. Les identifiants exacts du catalogue se rattachent à ce modèle sans changer son identité publique.
3

Configurer l’endpoint

Saisissez l’URL de base, avant le chemin d’inférence. Par exemple :
N’incluez pas /chat/completions ni /responses. Saisissez séparément l’identifiant exact du modèle ou du déploiement amont ; Phaseo le substitue lors du transfert des requêtes.
4

Enregistrer l’identifiant

Saisissez la clé API du déploiement. Phaseo chiffre l’identifiant et ne le renvoie jamais après l’enregistrement. Vous pouvez le remplacer plus tard depuis la page de paramètres du modèle.
5

Appeler le modèle

Utilisez l’identifiant de modèle généré avec l’endpoint Chat Completions habituel :
cURL
La clé API appelante doit appartenir au même espace de travail que le modèle privé.

Fonctionnement du routage

Un modèle autonome d’espace de travail n’est routé que vers son endpoint configuré. Un endpoint rattaché à un modèle du catalogue rejoint la liste de fournisseurs de ce modèle selon sa politique de routage : Phaseo envoie l’identifiant enregistré comme jeton Bearer et substitue l’identifiant de modèle amont configuré. Un modèle privé ne devient jamais une route de fournisseur publique et n’est pas visible par les autres espaces de travail. Les modèles privés activés figurent dans le catalogue de modèles authentifié et apparaissent sous le filtre Privé.
Après avoir ajouté, modifié ou activé un déploiement privé, attendez jusqu’à une minute avant de tester son routage. D’ici là, certaines requêtes peuvent encore utiliser la configuration précédente, par exemple les fournisseurs publics du modèle. Les requêtes déjà en cours ne sont pas réacheminées.

Exemples par fournisseur

Les produits et formats d’URL des fournisseurs peuvent changer. Vérifiez l’URL de base, l’identifiant de modèle, la méthode d’authentification et les endpoints pris en charge dans la documentation de déploiement actuelle du fournisseur.

Gérer les modèles privés via l’API

L’administration côté serveur peut utiliser l’API Private Models avec une clé de gestion portant private_models:read, private_models:write ou private_models:delete selon les besoins. Les requêtes de création et de mise à jour acceptent model_reference, soit un identifiant exact de modèle du catalogue, soit un slug court. Phaseo dérive model_id ; les clients ne peuvent pas l’envoyer directement. Utilisez host_provider_id pour un fournisseur Phaseo existant, ou custom_provider_name et éventuellement custom_provider_url pour un autre opérateur.

Dépannage

  • 404 du fournisseur : vérifiez que l’URL de base s’arrête avant le chemin d’inférence.
  • Modèle inconnu : copiez l’identifiant de déploiement amont du fournisseur dans Identifiant du modèle amont. N’y mettez pas l’identifiant de modèle de l’espace de travail Phaseo.
  • Requête amont non autorisée : remplacez l’identifiant enregistré et vérifiez que le fournisseur accepte l’authentification Bearer.
  • Chat fonctionne mais Responses échoue : désactivez Responses API, sauf si le fournisseur implémente /responses nativement.
  • Modèle absent du catalogue : vérifiez que le modèle est activé et que l’appelant est authentifié dans le même espace de travail.
Dernière modification le 16 novembre 2026