Erreurs et troubleshooting
Prismatic retourne des payloads d’erreur compatibles protocole pour gérer clairement auth, billing, validation et disponibilité modèle.
Erreurs fréquentes
400invalid_requestLe JSON body ne correspond pas au schéma de l’endpoint sélectionné.401invalid_api_keyLa clé API est manquante, invalide, révoquée ou liée à un compte suspendu.402billing_requiredLe quota abonnement est indisponible et PAYG ne peut pas couvrir la requête.404model_not_foundL’ID modèle public demandé n’est pas activé ou n’existe pas.429rate_limit_exceededLe compte ou la clé API dépasse sa limite par minute.503service_unavailableLa requête ne peut pas être complétée à cause d’une dépendance service temporairement indisponible.Formats d’erreur par protocole
- Les endpoints compatibles OpenAI retournent un objet
erroravecmessage,typeetcode. - Les endpoints compatibles Anthropic retournent des payloads d’erreur style Anthropic quand la requête utilise le protocole Messages.
- Ne parse pas du texte brut ; branche-toi sur le status HTTP et
code.
Troubleshooting
401 sur chaque requête
Régénère la clé dans le dashboard, confirme que le préfixe est correct et vérifie que l’intégration n’a pas tronqué le header.
Model not found
Appelle GET /v1/models avec la même clé API et utilise un des IDs publics retournés.
Erreurs billing
Vérifie d’abord le quota abonnement actif, puis le solde wallet et l’état PAYG.
Streaming interrompu tôt
Assure-toi que le client consomme le stream SSE jusqu’à la fin pour capturer l’usage final.