Passer au contenu

Documentation du développeur UlazAI

Erreurs et limites

Gestion des erreurs et limites de la plateforme

Utilisez une gestion structurée pour les erreurs API et validez les entrées côté client pour réduire tentatives.

Réponses HTTP courantes

Coder Signification Cause typique
400 Demande invalide prompt manquant, taille non prise en charge, paramètres de modèle non valides
401 Non autorisé Clé/jeton de session API manquant ou invalide
402 Paiement requis Crédits achetés insuffisants ou restriction d'accès API
403 Interdit Les points de terminaison de registre/connexion API sont intentionnellement désactivés
404 Pas trouvé L'ID de génération n'appartient pas à l'utilisateur actuel ou ne correspond pas au point de terminaison
500 Erreur de serveur Échec du fournisseur en amont ou délai d'attente du réseau

Limites de requête à appliquer côté client

  • prompt: maximum 5 000 caractères sur le point de terminaison unifié.
  • image_urls: maximum 14 URL sur un point de terminaison unifié.
  • size: spécifique au modèle, valider par rapport matrice de modèle.
  • quality: valeurs spécifiques au modèle pour Seedream 5 Lite, Nano Banana 2, Ideogram et Qwen.
  • L'utilisation de API nécessite l'achat de crédits ; les crédits de bienvenue sont uniquement disponibles sur le site Web.

Stratégie de nouvelle tentative

Comportement de production recommandé :

  • Ne réessayez pas 400, 401, 402, ou 403 sans changer d'entrée ou d'authentification.
  • Réessayer 500 avec un recul exponentiel et une saisie d'idempotence dans votre couche d'application.
  • Interrogez le point de terminaison d’état avant de lancer des tâches de génération de doublons.