Correction des erreurs

Utilisez le symptôme et le statut HTTP pour trouver la cause, vérifiez le correctif minimal, puis rétablissez la requête étape par étape.

401 Non authentifié

• Symptôme : La requête renvoie généralement 401 Non authentifié ; le client peut afficher seulement « requête échouée ».
• Cause : La Key est absente, inactive, incomplète ou envoyée avec le mauvais en-tête.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Recopiez la Key, retirez les espaces et vérifiez Bearer, x-api-key ou x-goog-api-key selon le protocole.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

403 Accès refusé

• Symptôme : La requête renvoie généralement 403 Accès refusé ; le client peut afficher seulement « requête échouée ».
• Cause : La Key, l'état du compte ou l'accès au modèle ne permet pas cette requête.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Confirmez que la Key est active et choisissez un modèle actuellement accessible sur le portail.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

404 Introuvable

• Symptôme : La requête renvoie généralement 404 Introuvable ; le client peut afficher seulement « requête échouée ».
• Cause : La Base URL, le chemin ou la méthode HTTP ne correspond pas ; le client peut aussi ajouter /v1 deux fois.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Comparez la méthode et le chemin complets avec le guide et saisissez uniquement le niveau de Base URL indiqué.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

429 Trop de requêtes

• Symptôme : La requête renvoie généralement 429 Trop de requêtes ; le client peut afficher seulement « requête échouée ».
• Cause : Les requêtes arrivent trop vite ou le solde actuellement disponible est insuffisant.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Réduisez la concurrence, réessayez avec des délais croissants et vérifiez l'état du compte sur le portail.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

5xx Erreur de service

• Symptôme : La requête renvoie généralement 5xx Erreur de service ; le client peut afficher seulement « requête échouée ».
• Cause : Un service amont ou la passerelle ne peut pas terminer la requête temporairement.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Conservez l’heure et le statut, puis réessayez. Si le problème persiste, utilisez la requête curl minimale pour isoler le client.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

Interruption réseau

• Symptôme : La requête renvoie généralement Interruption réseau ; le client peut afficher seulement « requête échouée ».
• Cause : Le réseau local, un proxy ou une connexion longue a été coupé avant la fin.
• Vérifications :
  1. Notez le statut HTTP complet, le chemin et l’heure.
  2. Recopiez la Key et vérifiez les espaces, l’expiration et l’activation.
  3. Comparez l’adresse, le modèle et l’en-tête d’authentification avec le guide, puis testez avec curl minimal.
• Correction : Vérifiez le domaine, reconnectez les flux avec temporisation et ne répétez pas automatiquement une opération non idempotente.
• Vérification : Après correction, envoyez d’abord une courte requête texte et ne réactivez les paramètres avancés qu’après une réponse JSON normale.

Ordre de vérification recommandé

1. Notez d’abord l’erreur complète : statut HTTP, chemin, client et heure.
2. Reproduisez-la avec la requête curl minimale du guide de démarrage pour isoler la Key, le modèle, l’adresse ou le client.
3. Ne changez qu’un élément à la fois. Vérifiez une courte requête texte avant de réactiver le streaming, les outils ou les paramètres média.

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.

Diagnostic des erreurs vidéo

Localisez l'erreur : avant envoi,analyse PopGo,acceptation,interrogation ou téléchargement. Gardez le message exact ;500 ou absence de logs ne suffisent pas.

Étape	Action
first-frame requires exactly one / first-last-frame requires both	Sélectionnez le mode et une image ou deux emplacements distincts ; vérifiez connexions et nombres
reference-audio requires at least one / audio not supported	Vérifiez capacité et autorisation du mode ; fournissez l'audio ;generate_audio n'accorde aucun droit d'entrée
unsupported protocol: data / invalid source	URL publique autorisée pour les modèles URL-only ; un badge Local ne publie pas le fichier
0% prolongé / completed sans téléchargement	Consultez l'id existant et laissez préparer le contenu, sans recréer
Succès sans référence	Champs,accessibilité puis résultat ;HTTP200 ne suffit pas

400 demande généralement une correction ;500 peut venir de l'analyse ou d'un intermédiaire ;503 indique souvent une capacité temporairement absente. Examinez les détails expurgés. Voir Diagnostic vidéo.