> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codes d’erreur courants

Ce document résume les codes d’erreur les plus courants renvoyés par la plateforme d’API Novita, avec leurs définitions, leurs causes et les solutions recommandées pour aider les utilisateurs à résoudre efficacement les problèmes.

***

## 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 forme `Authorization: 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](https://novita.ai/settings/key-management), elle ne permet donc plus l’authentification.

**Solution** :

* 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](/docs/fr/guides/llm-api-keys) 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](/docs/fr/guides/llm-model-access) 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](/docs/fr/guides/llm-model-access) 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_timeout` et `proxy_timeout` dépassent 60 secondes ;
* **Éviter les périodes de pointe** : pour les scénarios à forte concurrence, réessayez pendant les heures creuses.

**Pour les opérations de plateforme** :

* Améliorer la supervision et l’auto-scaling des services de modèles ;
* Ajuster correctement `proxy_read_timeout` au 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 `message` dans 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.