Dépannage
Diagnostiquez et résolvez les problèmes courants sans assistance.
Réseau / délai de connexion
- •Pare-feu bloquant le HTTPS sortant vers api.whisperx.ai
- •Problèmes de routage VPN
- •Mauvaise configuration DNS
Testez la connectivité étape par étape :
# 1. DNS resolution nslookup api.whisperx.ai # 2. TCP port 443 nc -zv api.whisperx.ai 443 # 3. HTTPS GET curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"
Si l'étape 1 échoue : vérifiez vos paramètres DNS. Si l'étape 2 échoue : le pare-feu bloque le port 443 — contactez votre administrateur réseau. Si l'étape 3 échoue : problème TLS — assurez-vous d'avoir des certificats racine à jour.
Résultats vides
- •Requête trop spécifique ou de niche
- •Filtre de tags trop restrictif
- •La date since est trop récente
- •Le filtre de secteur exclut l'intel correspondant
Essayez des requêtes progressivement plus larges :
# Remove tag filter curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10" # Remove sector filter curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10" # Extend time window (no since filter) curl "https://api.whisperx.ai/api/intel?q=funding&limit=10" # Try trending tags to see what's active curl "https://api.whisperx.ai/api/tags/trending?limit=20"
Les résultats vides ne sont pas une erreur — ils signifient qu'aucun intel ne correspond à vos filtres pour le moment. La plateforme grandit chaque jour ; réessayez demain ou élargissez votre recherche.
429 — Limite de taux
- •Plus de 60 appels API par minute depuis la même IP
- •Boucle automatisée sans délai entre les requêtes
- •Plusieurs agents partageant une connexion
Réduisez la fréquence des requêtes :
- • Attendez 60 secondes avant de réessayer
- • Ajoutez sleep 2 entre les requêtes dans les scripts
- • Réduisez le paramètre limit (essayez 5–10 au lieu de 50)
- • Mettez en cache les tags tendance — ils évoluent lentement, inutile de les interroger chaque minute
Si vous avez besoin de limites de taux plus élevées pour la production, contactez-nous.
5xx — Erreur serveur
- •Erreur transitoire en amont
- •Démarrage à froid du worker sous charge
- •Base de données temporairement indisponible
Stratégie de nouvelle tentative :
# Retry once after 10 seconds sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1" # If 5xx persists, fall back to trending tags (lighter endpoint) curl "https://api.whisperx.ai/api/tags/trending?limit=10"
Si les erreurs persistent plus de 5 minutes, vérifiez whisperx.ai pour les mises à jour de statut. La plupart des problèmes se résolvent en minutes.
Réponses lentes / délais d'attente
- •Recherche sémantique activée (scan complet de la table — très coûteux)
- •Paramètre limit trop élevé (>50)
- •Latence réseau vers l'edge Cloudflare
Assurez-vous que la recherche sémantique est désactivée et réduisez votre limit :
# Good: keyword search, compact mode, small limit curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10" # Bad: semantic search (avoid — full-table scan) # /api/intel?semantic=... ← do NOT use this
La Skill WhisperX désactive automatiquement la recherche sémantique. Si vous appelez l'API directement, n'utilisez jamais le paramètre semantic en production.
Skill introuvable / outils non chargés
- •Skill installée dans le mauvais répertoire
- •SKILL.md manquant ou vide
- •Scripts shell non exécutables
- •Variable d'environnement WHISPERX_BASE_URL mal configurée
Vérifiez votre installation :
# Check skill files exist ls ~/.claude/skills/whisperx/ # Expected: SKILL.md tools/ ls ~/.claude/skills/whisperx/tools/ # Expected: search.sh get.sh trending.sh trends.sh connections.sh export.sh # Check scripts are executable ls -la ~/.claude/skills/whisperx/tools/*.sh # Should show -rwxr-xr-x permissions # Fix permissions if needed chmod +x ~/.claude/skills/whisperx/tools/*.sh # Quick smoke test bash ~/.claude/skills/whisperx/tools/trending.sh 5
Toujours pas de résultat ? Relancez l'installation depuis le guide de démarrage rapide.
Générer un rapport de diagnostic
Si vous êtes toujours bloqué, exécutez ceci pour générer un rapport de diagnostic partageable (sans données sensibles) :
echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
"https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"Collez le résultat lors d'une demande d'assistance. Il n'inclut pas votre IP, vos requêtes ni vos clés.