Aller au contenu principal

Questions fréquentes

Vérifiez d’abord la requête API et la configuration du client, puis passez à l’erreur précise.

Requêtes API​

Comment vérifier que la Key API a été copiée entièrement​

Une Key est généralement affichée en entier une seule fois. Copiez-la dans un emplacement local sûr et vérifiez les espaces, retours à la ligne et guillemets typographiques. Si la valeur complète n’est plus visible, désactivez l’ancienne Key et créez-en une nouvelle.

Dois-je tester le logiciel ou curl en premier​

Testez curl en premier. L’adresse, la Key, le modèle et le corps de la requête restent explicites, ce qui écarte le cache et les variables héritées du client.

Pourquoi curl fonctionne mais pas le logiciel​

Vérifiez le type de Provider, le niveau de Base URL, les champs API Key et Model, puis créez une nouvelle conversation ou redémarrez le client.

Quelle est la différence entre Base URL et Endpoint complet​

La Base URL est la racine du protocole et le client ajoute le chemin. Un Endpoint complet contient déjà le chemin de l’opération.

Pourquoi la liste des modèles est-elle vide​

De nombreux clients ne récupèrent pas les modèles tiers. Si la Key et la Base URL sont correctes, copiez YOUR_MODEL depuis les modèles et tarifs et saisissez-le manuellement.

Comment savoir si le compte ou le quota est insuffisant​

Si la requête renvoie 403 ou 429 après vérification de la Key, du modèle et du chemin, consultez l’état du compte, le quota et la disponibilité du modèle dans le portail. Ne vous fiez pas à une ancienne capture du document public.

Isoler le problème avec une requête minimale​

Gardez l’adresse, la Key, le modèle et le corps fixes et envoyez un court message. Si curl réussit, vérifiez le client ou une ancienne session ; sinon utilisez le statut HTTP dans Correction des erreurs.

Client et environnement local​

Commande introuvable​

  • Symptôme : Le client ou le terminal affiche généralement « Commande introuvable », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Le terminal ne trouve pas claude, codex ou gemini, souvent parce que le dossier d’installation n’est pas dans PATH ou que l’ancien terminal n’est pas rafraîchi.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Ouvrez un nouveau terminal et lancez la commande de version. Si l’erreur persiste, réinstallez depuis la source officielle et évitez les miroirs inconnus.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Variables d’environnement inactives​

  • Symptôme : Le client ou le terminal affiche généralement « Variables d’environnement inactives », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Les variables ont été définies dans un terminal, mais l’application démarre depuis une autre fenêtre, un raccourci ou un processus en arrière-plan.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Affichez les variables dans le terminal qui lance l’application, puis fermez les anciennes sessions et rouvrez après configuration.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Les réglages enregistrés utilisent encore le service par défaut​

  • Symptôme : Le client ou le terminal affiche généralement « Les réglages enregistrés utilisent encore le service par défaut », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Le client peut garder l’ancien Provider en cache, ou la conversation active n’a pas basculé vers la nouvelle configuration.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Créez une conversation ou redémarrez le client, puis vérifiez que Provider, Base URL, Key et modèle viennent de PopGo.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Modèle indisponible​

  • Symptôme : Le client ou le terminal affiche généralement « Modèle indisponible », ou la configuration est enregistrée mais la requête échoue.
  • Cause : L’orthographe de l’ID, la portée d’accès ou la disponibilité en direct a changé.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Recopiez l’ID depuis les modèles et tarifs, puis vérifiez avec une requête minimale au lieu de le saisir depuis une ancienne capture.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Erreur de permission lors de l’installation globale npm​

  • Symptôme : Le client ou le terminal affiche généralement « Erreur de permission lors de l’installation globale npm », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Windows peut refuser l’installation, tandis que macOS/Linux peut utiliser un répertoire global non accessible à cause de la méthode d’installation de Node.js.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Sous Windows, rouvrez au besoin PowerShell avec les droits appropriés. Sous macOS/Linux, préférez la méthode officielle ou un gestionnaire de paquets afin que le répertoire global appartienne à l’utilisateur courant ; ne dépendez pas durablement de sudo npm install -g.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Claude Code demande la connexion à un compte officiel​

  • Symptôme : Le client ou le terminal affiche généralement « Claude Code demande la connexion à un compte officiel », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Claude Code n’a pas lu les variables d’environnement et est revenu à son parcours de connexion officiel.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Vérifiez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN dans le même terminal, fermez les anciennes fenêtres, redémarrez l’outil et lancez claude doctor.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Codex signale une erreur d’authentification​

  • Symptôme : Le client ou le terminal affiche généralement « Codex signale une erreur d’authentification », ou la configuration est enregistrée mais la requête échoue.
  • Cause : La configuration locale ne lit pas POPGO_API_KEY, ou le Provider, model_provider et env_key de config.toml ne correspondent pas.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Vérifiez que le nom est exactement POPGO_API_KEY, puis contrôlez que model_provider = popgo correspond à model_providers.popgo.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

La Base URL renvoie 404​

  • Symptôme : Le client ou le terminal affiche généralement « La Base URL renvoie 404 », ou la configuration est enregistrée mais la requête échoue.
  • Cause : L’application peut ajouter un chemin à la valeur saisie, ce qui produit /v1/v1 ou un Endpoint complet dupliqué.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Consultez le tableau des niveaux de Base URL dans Quickstart : mettez la racine du protocole dans Base URL et le chemin complet uniquement dans un champ Endpoint complet.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Erreur de certificat ou SSL​

  • Symptôme : Le client ou le terminal affiche généralement « Erreur de certificat ou SSL », ou la configuration est enregistrée mais la requête échoue.
  • Cause : Les causes courantes sont un proxy local, une interception du réseau de l’entreprise, une horloge système incorrecte ou une chaîne de certificats défaillante.
  • Vérifications :
    1. Vérifiez commande, variables, Provider, Base URL, Key et modèle depuis la même session qui lance le client.
    2. Fermez les anciennes sessions et relancez le client.
    3. Comparez l’adresse finale avec le tableau du démarrage rapide.
  • Correction : Ne désactivez pas la vérification TLS. Vérifiez l’horloge, testez sans proxy local ou depuis un autre réseau, puis contrôlez l’interception HTTPS par les logiciels de sécurité.
  • Vérification : Relancez le client et envoyez un court message. La reprise exige un contenu normal avec l’adresse, le modèle et l’authentification attendus.

Audio de référence ou son de sortie ?​

generate_audio règle la piste de sortie, pas la capacité d'entrée. Les capacités déterminent le libellé vidéo/audio,vidéo seule ou audio seul. Le mode vidéo exige une vidéo ; le mode audio exige un audio.

Pourquoi C propose l'audio mais pas la vidéo ?​

C exclut la vidéo ; vider une limite0 ne doit pas la contourner. Jusqu'à 3 fichiers audio de référence sont acceptés. Kling n'a pas publié de champs d'entrée audio de référence ; ils restent fermés. Grok les exclut aussi.

Coller un média en ligne conserve-t-il toujours son URL ?​

Une URL HTTP(S) explicite est conservée ; les octets copiés seuls restent locaux. Un média généré est public seulement si sourceUrl est gardée. Les badges inspectent la source, sans garantir l'accès du service. Les modèles sans Base64 exigent une URL accessible.

Pourquoi un ID sans effet de référence ?​

L'ID prouve uniquement l'acceptation. Vérifiez mode,champs,téléchargement,résultat. Première image et référence ordinaire diffèrent ; un champ ignoré peut quand même engendrer des frais. Voir Cycle vidéo.

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.