Aller au contenu principal

Erreurs courantes et récupération

Notez le statut HTTP et le chemin avant de choisir une action.

401 Non authentifié

La Key est absente, inactive, incomplète ou envoyée avec le mauvais en-tête.

Recopiez la Key, retirez les espaces et vérifiez Bearer, x-api-key ou x-goog-api-key selon le protocole.

403 Accès refusé

La Key, l'état du compte ou l'accès au modèle ne permet pas cette requête.

Confirmez que la Key est active et choisissez un modèle actuellement accessible sur le portail.

404 Introuvable

La Base URL, le chemin ou la méthode HTTP ne correspond pas ; le client peut aussi ajouter /v1 deux fois.

Comparez la méthode et le chemin complets avec le guide et saisissez uniquement le niveau de Base URL indiqué.

429 Trop de requêtes

Les requêtes arrivent trop vite ou le solde actuellement disponible est insuffisant.

Réduisez la concurrence, réessayez avec des délais croissants et vérifiez l'état du compte sur le portail.

5xx Erreur de service

Un service amont ou la passerelle ne peut pas terminer la requête temporairement.

Conservez l’heure et le statut, puis réessayez. Si le problème persiste, utilisez la requête curl minimale pour isoler le client.

Interruption réseau

Le réseau local, un proxy ou une connexion longue a été coupé avant la fin.

Vérifiez le domaine, reconnectez les flux avec temporisation et ne répétez pas automatiquement une opération non idempotente.

Si le problème persiste

Conservez l'heure, le protocole, la méthode, le chemin, le statut et un extrait expurgé. N'incluez jamais la Key complète.