Passer au contenu principal
Basez votre logique sur error.code et le statut HTTP, pas sur le texte du message. Toutes les erreurs Phaseo ont le même corps JSON sur tous les endpoints, et leur objet error (code, message, type, param) a la forme que lisent les SDK compatibles OpenAI : leurs exceptions contiennent donc le message de Phaseo.

Champs présents dans chaque erreur

Certaines erreurs ajoutent du contexte :

Types d’erreur

error.type suit les types d’erreur documentés d’OpenAI et est défini à partir du statut HTTP : Les erreurs sur /v1/messages utilisent le même corps : les SDK Anthropic y trouvent donc aussi error.type et error.message.

Codes d’erreur

Réessayer les bonnes erreurs

Fixez un nombre maximal de tentatives et une échéance globale. Consultez Limites de débit pour les en-têtes de limite de débit.

En cas d’échec d’un fournisseur

Lorsque Phaseo a atteint un fournisseur et que la requête a tout de même échoué, provider_failure_diagnostics contient une category, un hint et le provider. Catégories :

Lorsqu’un modèle ou un endpoint n’est pas disponible

Les erreurs unsupported_model_or_endpoint peuvent contenir provider_candidate_diagnostics, provider_enablement, missing_pricing_providers et routing_diagnostics. Ensemble, ils permettent de distinguer un modèle pas encore actif, un modèle qui ne prend pas en charge l’endpoint, une tarification manquante et des restrictions de déploiement.

Lorsqu’un modèle est retiré

Un modèle retiré reste servi tant qu’un fournisseur le sert. Dès qu’aucun ne le sert plus, les requêtes échouent avec 410 et model_retired :
model est le modèle demandé, retired_at la date de son retrait (ou null), et replacement_model le remplaçant suggéré (ou null). Réessayer ne sert à rien ; changez l’ID du modèle. Pour que ces requêtes continuent de fonctionner pendant la migration, ajoutez le remplaçant à la liste models de la requête ou activez le routage des modèles retirés pour l’espace de travail. Consultez Dépréciation et retrait des modèles.

Erreurs pendant un flux

Si une requête échoue avant le début du streaming, vous recevez le corps d’erreur JSON ci-dessus. Si elle échoue en cours de flux, le flux se termine par l’événement d’échec de l’endpoint au lieu d’une fin normale : Considérez la sortie partielle comme incomplète et proposez de réessayer. La trame error de Chat Completions contient le même objet d’erreur, avec error.type défini à partir du code :
Une requête sans streaming dont le fournisseur échoue en cours de route renvoie 502 avec upstream_stream_failure, et non une réponse partielle. Consultez Streaming.

Déboguer une requête

Envoyez un objet debug pour obtenir les traces de routage et les charges utiles échangées avec le fournisseur :
trace_level vaut summary ou full. Les charges utiles de débogage peuvent contenir le contenu de votre requête : ne les utilisez qu’en développement ou dans des environnements étroitement contrôlés. Consultez debug. Lorsqu’une requête échoue, consultez la page d’état pour les incidents, comparez votre charge utile à la page de référence de l’endpoint, et journalisez generation_id avec l’endpoint et le modèle. Indiquez generation_id lorsque vous contactez le support.
Dernière modification le 5 novembre 2026