Résolution des problèmes de connexion

Effectuez ces vérifications dans l’ordre. Ne modifiez qu’un seul paramètre à la fois.

1. Vérifier la clé API

  • Supprimez les espaces situés au début ou à la fin.
  • Vérifiez que la clé est activée, non expirée et qu’elle dispose encore d’un quota.
  • Vérifiez que le processus peut lire la variable d’environnement configurée.
  • Ne collez pas la clé complète dans les journaux ou les messages adressés à l’assistance.

2. Vérifier le protocole et l’URL

ProtocoleBase URLOpération ajoutée par le client
Chat Completionshttps://getrouter.ai/v1/chat/completions
Responseshttps://getrouter.ai/v1/responses
Claude Messageshttps://getrouter.ai/v1/messages
Geminihttps://getrouter.ai/v1beta/models/...

Une erreur 404 signifie souvent que le client a ajouté deux fois /v1 ou le chemin d’une opération.

3. Vérifier le modèle

  • Copiez l’ID exact du modèle depuis Modèles.
  • Vérifiez que la clé est autorisée à utiliser ce modèle.
  • Vérifiez que le modèle prend en charge le protocole et la fonctionnalité demandés.
  • Saisissez manuellement le modèle si l’outil ne parvient pas à charger une liste de modèles.

4. Interpréter les statuts courants

StatutSignification à vérifier en premier
400Champ non pris en charge, requête non valide ou fonctionnalité incompatible
401Clé API manquante ou non valide
403Restriction liée à la clé, au modèle, au groupe ou à la stratégie
404URL ou chemin incorrect, ou modèle inconnu
429Limite de solde, de quota, de concurrence ou de débit
5xxDéfaillance temporaire du fournisseur amont ou de la passerelle

5. Tester une requête minimale

Désactivez les outils, les fichiers, les images, le contexte long, le mode JSON et les paramètres de raisonnement personnalisés. Envoyez un court prompt textuel. Réactivez ensuite les fonctionnalités avancées une par une.

Demander de l’aide en toute sécurité

Indiquez l’outil et sa version, le protocole, l’ID du modèle, l’URL de base expurgée, le statut HTTP, le texte de l’erreur, l’ID de requête, ainsi que l’heure et le fuseau horaire. Ne communiquez jamais la clé API complète.