Dépannage

Suivez la section qui correspond au symptôme que vous observez. Dans presque tous les cas, l'onglet Logs est le moyen de diagnostic le plus rapide : il affiche le statut de chaque requête et le schéma d'échec (une seule clé ? un seul modèle ? tout ?). Consultez Activité et journaux.

Les requêtes sont bloquées

Toutes les requêtes échouent avec l'erreur 402 insufficient_credits

Cause : le module n'est pas activé pour cette installation, ou le solde prépayé est épuisé (l'onglet Overview affiche alors "Your balance is depleted. Inference requests will be blocked until you top up."). Pour les clés API, une installation où Model Router n'est pas activé renvoie plutôt l'erreur 403 "Model Router is not enabled for this facility".

Solution : activez Model Router depuis la page Welcome to Model Router (consultez Prise en main), puis rechargez votre solde sous Budgets & Limits → Balance & Top-up. Les requêtes reprennent quelques instants après le crédit du solde. Pour éviter que le problème ne se reproduise, activez le rechargement automatique. Consultez Budgets et rechargements.

Les requêtes échouent avec l'erreur 402 budget_exceeded

Cause : une limite de dépenses a été atteinte. Le message d'erreur indique la période concernée (quotidienne / mensuelle / à vie) et, pour les limites quotidiennes et mensuelles, le moment exact de leur réinitialisation dans le fuseau horaire de votre installation. Il peut s'agir de la limite à l'échelle du compte ou d'une limite propre à la clé ou au service connecté (le message indique "This key's" / "This agent's" lorsque la limite est ciblée).

Solution : attendez la réinitialisation indiquée, augmentez la limite (Budgets & Limits → Spend Limits, ou la configuration de la clé ou du service) ou, pour le plafond absolu à vie, utilisez Reset hard cap. La page Spend Limits indique précisément quelles limites affichent "Limit reached".

Les requêtes échouent avec l'erreur 403 content_policy_violation

Cause : l'invite correspond à un filtre de contenu en mode block ou au bouclier contre l'injection d'invites.

Solution : vérifiez Settings → Guardrails. Si une intégration a légitimement besoin de règles différentes, utilisez son option Override facility guardrails plutôt que d'assouplir la politique applicable à toute l'installation. Consultez Garde-fous.

Les requêtes échouent avec l'erreur 429

Cause : la clé ou le service connecté a dépassé sa limite de débit Requests / min ou Tokens / min.

Solution : espacez les requêtes et réessayez, ou augmentez les limites de débit dans la configuration de la clé ou du service (vide = illimité). Consultez Clés API.

Un modèle précis renvoie des erreurs, les autres fonctionnent

Cause : le modèle est peut-être désactivé pour votre installation, exclu par la restriction de modèles de la clé, ou le fournisseur rencontre peut-être des problèmes.

Solution : vérifiez Settings → Models (le modèle est-il activé ?), la liste Restrict models de la clé, ainsi que Activity → Performance → Reliability & performance by model pour suivre le taux d'erreur du modèle dans le temps.

Problèmes de clés API

401 Unauthorized

Cause : avec le code invalid_api_key ("Missing or invalid API key"), l'en-tête Authorization: Bearer … est absent ou mal formé. Sans code ("Invalid API key"), la clé est inconnue (mal saisie, ou ancien secret après une rotation) ou révoquée.

Solution : vérifiez le format de l'en-tête et l'état de la clé dans Settings → Service Access & API Keys. Réactivez une clé révoquée, ou mettez à jour votre service avec le nouveau secret si la clé a fait l'objet d'une rotation.

J'ai perdu le secret de la clé

Le secret n'est affiché qu'une seule fois, à la création, et ne peut pas être récupéré. Utilisez Rotate : un nouveau secret est émis (affiché une seule fois) et la clé conserve son libellé, ses limites et son historique. Mettez à jour chaque service qui utilise la clé : "You will need to reconfigure any services still using the old key."

La clé fonctionne, mais l'utilisation apparaît sous le mauvais nom

Les clés sont identifiées par leur Label dans Activity et Logs. Modifiez la clé et attribuez-lui un libellé explicite ; donnez à chaque système sa propre clé plutôt que d'en partager une.

Problèmes d'agents

Un agent affiche Offline

Cause : l'appareil est éteint ou n'a pas de connectivité. Il s'agit de la connectivité de l'appareil, et non d'un paramètre de Model Router.

Solution : vérifiez l'alimentation et le réseau de l'appareil. Sa configuration d'accès n'est pas affectée et fonctionne de nouveau dès qu'il se reconnecte.

Un agent ne répond plus aux requêtes d'IA

Vérifiez, dans l'ordre :

1. Solde : un solde épuisé bloque tous les agents (l'agent affiche un état indiquant que des crédits sont requis). Rechargez votre solde.
2. Limites par service : Settings → Service Access & API Keys → Connected Services : l'agent affiche-t-il "Limit reached" ? Augmentez la limite ou attendez sa réinitialisation.
3. Limites du compte : Budgets & Limits → Spend Limits.
4. Journaux : filtrez sur l'agent pour voir l'erreur réelle de ses requêtes.

Questions sur le solde et la facturation

Les montants dépensés semblent en retard

Les montants Available balance et Spent today sont en temps réel. Monthly usage est rapproché de votre solde toutes les 15 minutes ; les dépenses très récentes peuvent donc mettre quelques minutes à y apparaître. L'historique des transactions ne répertorie que les rechargements et les ajustements de solde ; l'utilisation n'y figure donc jamais.

Le rechargement automatique ne s'est pas exécuté

Recherchez une bannière sur la page Balance & Top-up : aucune carte enregistrée, carte nécessitant une authentification ou carte refusée. Corrigez la carte (Update card / Edit payment details) ou rechargez manuellement. Les vérifications de rechargement automatique s'exécutent environ toutes les 15 minutes ; un seuil tout juste franchi peut donc mettre quelques minutes à déclencher un rechargement.

Un rechargement a échoué

"Additional card authentication is required. Please try again." : réessayez ; votre banque peut demander une vérification. "Top-up could not be completed." : le paiement a été refusé ; vérifiez la carte ou essayez un autre montant. Aucun crédit n'est appliqué tant que le paiement n'a pas abouti.

J'ai été débité, mais le solde n'a pas changé

Les rechargements sont crédités instantanément : actualisez la page. Si le solde ne reflète toujours pas un paiement réussi, notez le Transaction ID et la Payment reference indiqués dans le volet de détails de la transaction (ou sur votre relevé de carte) et créez une demande d'assistance.

Questions sur les journaux et les analyses

Une requête que je viens d'envoyer n'apparaît pas encore dans les journaux

Activez l'actualisation Live (ou cliquez sur Refresh now). Les requêtes apparaissent normalement en quelques instants ; en cas de forte charge, cela peut prendre un peu plus de temps.

Les journaux affichent un modèle que je n'ai pas demandé

Si vous avez envoyé model: "auto", les journaux affichent le modèle vers lequel l'Auto Router a résolu la requête. Ouvrez les détails de la requête pour voir Requested model: auto. Ce comportement est normal. Consultez Modèles.

Des lignes affichent « No charge »

Les réponses en échec ou vides qui n'ont rien coûté portent le badge No charge : elles sont enregistrées par souci d'exhaustivité, mais n'ont pas consommé de solde.

Mon export CSV est plus petit que prévu

Les exports bruts sont limités à 25,000 lignes : réduisez la plage de dates ou utilisez un export récapitulatif. À noter également : "Summaries cover whole days, so a sub-day or graph selection is widened to full days."