Concepts

Réponses d'erreur

Codes de statut HTTP courants, erreurs compatibles OpenAI et erreurs de tâches asynchrones.

TENSORAXIS s'efforce de renvoyer une forme d'erreur qui correspond au style d'API que vous utilisez. Les API compatibles OpenAI renvoient généralement un objet error ; les API de tâches asynchrones renvoient généralement code, message et data.

Erreurs compatibles OpenAI

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_request"
  }
}

Champs :

ChampDescription
error.messageMessage d'erreur lisible par un humain
error.typeType d'erreur provenant de TENSORAXIS ou du fournisseur en amont
error.paramParamètre de requête concerné, lorsqu'il est disponible
error.codeCode d'erreur, généralement plus stable que message

Erreurs des tâches asynchrones

Les API de tâches asynchrones telles que la vidéo, la musique et le dessin peuvent renvoyer :

{
  "code": "invalid_request",
  "message": "prompt is required",
  "data": null
}

Pour la génération vidéo, une erreur de requête courante est un prompt manquant. Si vous envoyez directement le corps content[] de niveau supérieur de style Volcengine en amont à /v1/video/generations, TENSORAXIS ne peut pas lire un champ prompt et renvoie 400 prompt is required.

Codes de statut HTTP courants

StatutSignificationCorrection courante
400Corps, paramètre ou format de modèle invalideVérifiez le JSON, les champs requis et le nom du modèle
401Échec de l'authentificationVérifiez le token et l'en-tête d'authentification
403Problème de permission ou de quotaVérifiez la portée du token, le quota du compte et l'accès au groupe
404Ressource introuvableVérifiez le nom du modèle, l'ID de tâche ou le chemin
429Limite de débit dépasséeRéduisez la concurrence, réessayez plus tard, ou ajustez les limites de token/groupe
5xxErreur serveur ou en amontRéessayez plus tard ; contactez le support si le problème persiste

Pour les clients automatisés, basez votre logique sur les codes de statut HTTP et les valeurs de code plutôt que sur la correspondance du texte complet de message. Les messages peuvent varier selon le fournisseur en amont, la langue ou la configuration du déploiement.