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 erreursunsupported_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 avec410 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 :
502 avec upstream_stream_failure, et non une réponse partielle. Consultez Streaming.
Déboguer une requête
Envoyez un objetdebug 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.