Aller au contenu
SeoFreshUp Docs

Erreurs OpenRouter

OpenRouter envoie des codes d’erreur spécifiques quand quelque chose plante. Voici comment décoder les plus courants.

401 Unauthorized

OpenRouter: 401 No auth credentials found

Veut dire : ta clé API est manquante, malformée, ou révoquée.

Fixes

  1. Vérifie que la clé est collée correctement dans Réglages → Clés API & Modèles — pas d’espace en début/fin, commence par sk-or-
  2. Clique 🔌 Tester la clé — si fail, la clé est invalide
  3. Va sur openrouter.ai/keys, révoque l’ancienne, crée-en une nouvelle, colle dans le plugin

402 Payment Required

OpenRouter: 402 You have insufficient credits

Veut dire : ton solde OpenRouter est à zéro.

Fix

  1. Va sur openrouter.ai/credits
  2. Top up (recommandé : 10-20 $ pour ~6 mois d’usage normal)
  3. Réessaie l’action — les crédits se mettent à jour instantanément

404 Model Not Found

OpenRouter: 404 X is not a valid model ID

Veut dire : le modèle configuré n’existe pas (déprécié ou typo).

Fix

  1. Réglages → Clés API & Modèles
  2. Pour chaque rôle (Standard, Profond, Réécriture, Image), check l’ID du modèle
  3. Soit choisir dans le dropdown curé, soit cliquer 🔍 Découvrir les modèles dispo pour voir le catalogue OpenRouter live

429 Rate Limit

OpenRouter: 429 Rate limit exceeded

Veut dire : trop de requêtes trop vite. Courant quand tu cliques « Analyse complète » sur un blog 5000+ articles.

Fix

  1. Attends 30 secondes, réessaie
  2. Pour les opérations en masse, le plugin pace les requêtes automatiquement (max 5 concurrentes), mais les très gros blogs (>2000 articles) peuvent encore hit les limites
  3. Considère switch vers un modèle moins chargé (ex. claude-haiku-4.5 → gpt-4o-mini)

500 / 502 / 503 Server Errors

OpenRouter ou le fournisseur upstream a eu un souci temporaire.

Fix

Attends 1-5 minutes et réessaie. Si persistant (>30 min), check status.openrouter.ai.

« Réponse de réécriture non parseable »

Le modèle a renvoyé une sortie non-JSON (rare avec les modèles modernes, courant avec les anciens comme Llama 7B).

Fixes

  1. Switch le modèle Réécriture vers du plus fiable : anthropic/claude-haiku-4.5 ou openai/gpt-4o-mini
  2. Évite les variantes :online pour la réécriture (les modèles avec recherche web produisent souvent du texte libre)
  3. Évite les modèles avec très petite context window

« Pas de message dans la réponse » / Contenu vide

Le modèle a renvoyé une réponse mais avec contenu vide.

Causes

  • La modération de contenu s’est déclenchée (rare pour du SEO mais possible si ton article mentionne des sujets sensibles)
  • Le prompt était trop long pour la context window — le modèle a tronqué et renvoyé vide

Fixes

  1. Essaie un autre modèle avec plus de contexte (Claude Opus 4.7 = 200k tokens, Gemini 2.5 Pro = 2M tokens)
  2. Si ton article fait >5000 mots, considère le splitter en sections et réécrire chacune séparément

« Image gen: empty image in response »

Le modèle gen image a renvoyé une réponse chat sans image attachée.

Fixes

  1. Vérifie que le modèle supporte la génération d’image (doit avoir la modalité images sur OpenRouter)
  2. Switch vers un modèle testé : google/gemini-3-pro-image-preview
  3. Vérifie que « Activer la génération d’image » est on dans Réglages

Surveiller les coûts

Track tes dépenses OpenRouter sur openrouter.ai/activity. Set une alerte solde faible à 1-2 $ pour éviter les fails surprise pendant un long job.

La suite ?