Code d’erreur 400
Description : Paramètres de requête invalides.Solution :
Examinez les détails du message d’erreur et vérifiez si les formats des paramètres, les noms de champs ou les plages de valeurs sont conformes à la documentation de l’API.
Code d’erreur 401
Description : La clé API est manquante ou incorrecte.Causes courantes :
- Clé manquante : aucun en-tête
Authorization, ou l’en-tête n’est pas sous la formeAuthorization: Bearer <API Key>. - Clé erronée ou mal formée : une faute de frappe, un espace supplémentaire ou une valeur qui n’est pas une clé
sk_valide. - Clé supprimée : la clé a été supprimée dans Gestion des clés, elle ne permet donc plus l’authentification.
- Assurez-vous que la clé API est fournie dans la requête et utilise le schéma
Bearer; - Vérifiez que la clé API est correcte et existe toujours dans Gestion des clés ;
- Si vous utilisez des variables d’environnement ou des fichiers de configuration, confirmez qu’ils sont lus correctement pendant l’exécution. Consultez Clés API pour savoir comment stocker et charger une clé.
Code d’erreur 403
Description : Accès refusé en raison d’autorisations insuffisantes.Accès au modèle refusé (model_access_denied)
La clé API est valide, mais elle n’est pas autorisée à appeler le modèle demandé. L’accès aux modèles de la clé est restreint, et le modèle demandé se trouve en dehors de sa portée.
Solution :
- Appelez un modèle qui se trouve dans la portée d’accès de la clé, ou
- Demandez à l’administrateur de votre équipe d’ajuster l’accès aux modèles de la clé afin d’inclure le modèle.
Le modèle nécessite une vérification d’identité
Certains modèles nécessitent une vérification d’identité avant que votre compte puisse y accéder. Solution :- Vérifiez que le compte associé à la clé API dispose de l’autorisation d’accéder au modèle demandé ;
- Connectez-vous à la console et vérifiez le statut de vérification de votre compte ;
- Si le compte n’est pas vérifié, effectuez d’abord la vérification d’identité ;
- Vous pouvez également utiliser une clé API provenant d’un compte déjà vérifié.
Code d’erreur 429
Description : Limite de débit dépassée (Too Many Requests).Solution :
- Vérifiez si la limite est due au TPM (tokens par minute) ou au RPM (requêtes par minute) ;
- Consultez la documentation officielle sur les limites de débit ;
- Pour augmenter votre limite de débit, contactez le support ou utilisez un compte vérifié.
Code d’erreur 503 / 504
Description : Délai d’attente du backend ou service indisponible, souvent causé par une forte charge système ou une limitation du trafic.Causes possibles :
- Surcharge GPU ou CPU sur les nœuds de service du modèle ;
- Le temps de génération long pour les requêtes non streaming dépasse le délai d’attente de la passerelle ;
- Défaillances dans les services en aval (par exemple, Redis, moteur de modèle) ;
- Le module de gestion du trafic a activé la protection contre les pics de charge et a renvoyé 503.
Solutions recommandées :
Pour les utilisateurs de l’API :- Activer un mécanisme de nouvelle tentative : utilisez un backoff exponentiel pour éviter les surcharges répétées ;
- Passer au mode streaming : les réponses en streaming renvoient les tokens au fur et à mesure de leur génération, réduisant la latence et le risque de délai d’attente ;
- Optimiser les paramètres client : assurez-vous que
client_timeoutetproxy_timeoutdépassent 60 secondes ; - Éviter les périodes de pointe : pour les scénarios à forte concurrence, réessayez pendant les heures creuses.
- Améliorer la supervision et l’auto-scaling des services de modèles ;
- Ajuster correctement
proxy_read_timeoutau niveau de la passerelle ; - Mettre en œuvre des règles de limitation fines (par exemple, files d’attente prioritaires, priorisation du cœur de métier) ;
- Utiliser Prometheus + Alertmanager pour déclencher des alertes en cas de pics de 503/504.
Code d’erreur 500
Description : Erreur interne du serveur — généralement causée par des exceptions backend ou des plantages du moteur de modèle.Solution :
- Ces problèmes nécessitent généralement une résolution côté plateforme. Contactez le support pour analyser les journaux et les ressources système ;
- Vous pouvez également essayer de changer de modèle ou de revenir à une configuration moins gourmande en ressources.
Autres erreurs
Pour les erreurs non définies ou non documentées :- Commencez par consulter le champ
messagedans la réponse de l’API ; - Ensuite, vérifiez les journaux de requêtes ou les traces de la console ;
- Enfin, contactez le support Novita ou soumettez un ticket pour obtenir une assistance supplémentaire.