Configuration de Qwen Code : API Key, Base URL et modèles

Connectez Qwen Code à BetterToken via modelProviders.openai dans ~/.qwen/settings.json. Lors d’un test sur macOS avec un modèle GPT, Qwen Code 0.26.0 a traité des requêtes texte avec Responses et Chat Completions.

Les tâches de lecture de fichiers se sont révélées peu fiables avec Qwen Code 0.26.0. Chat Completions a renvoyé une réponse finale vide lors des trois essais ; Responses a renvoyé la bonne réponse deux fois sur trois. Les résultats des outils contenaient le bon contenu, mais la cause des échecs de réponse finale reste inconnue. Ne comptez pas encore sur cette configuration pour lire des fichiers.

Paramètres clés

Élément	Valeur
API Key	BetterToken API Key référencée par envKey
Base URL	https://bettertoken.ai/v1 dans baseUrl
Modèle	YOUR_MODEL_ID
Configuration du fournisseur	modelProviders.openai
Format API	wireApi: "responses"

Prérequis

• Node.js 22 ou version ultérieure pour l’installation npm ci-dessous
• Une BetterToken API Key : inscrivez-vous pour en obtenir une
• Un Model ID copié depuis le model plaza

Installation

Utilisez l’option npm du guide de démarrage officiel :

npm install -g @qwen-code/qwen-code@latest
qwen --version

Configuration manuelle

Définissez l’API Key dans votre terminal en remplaçant YOUR_API_KEY :

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Ajoutez ces paramètres à ~/.qwen/settings.json. Remplacez les deux valeurs YOUR_MODEL_ID par le même Model ID exact :

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

envKey désigne une variable d’environnement ; il ne contient pas l’API Key elle-même. La référence officielle des fournisseurs de modèles prend également en charge wireApi: "chat-completions". Responses a donné de meilleurs résultats pour la lecture de fichiers lors de ce test, mais aucun des deux formats n’a réussi à chaque tentative.

Vérifier la connexion

Exécutez ce test texte dans le même terminal :

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

Vérifiez que la réponse finale contient OK. La réussite d’une requête texte ne garantit pas une réponse finale correcte pour une tâche de lecture de fichier ; tenez compte de la limite ci-dessus pour choisir votre méthode.

Changer de modèle

Ajoutez une entrée de modèle sous modelProviders.openai, définissez model.name sur son id exact, puis démarrez une nouvelle session.

Erreurs fréquentes

Symptôme	Vérification
Échec de l’authentification	Exportez la variable désignée par envKey dans le terminal qui exécute Qwen Code.
Point de terminaison incorrect	Utilisez https://bettertoken.ai/v1 dans baseUrl ; wireApi sélectionne le protocole de requête.
Modèle introuvable	Faites correspondre model.name à un id sous modelProviders.openai.
Réponse vide ou incorrecte après lecture d’un fichier	Cela s’est produit même lorsque les résultats des outils étaient corrects en version 0.26.0. Le passage à Responses n’a pas éliminé les échecs ; utilisez un autre client testé pour les tâches de lecture de fichiers.

Pages associées

• Comparer les outils pris en charge
• Erreurs API et limites de débit
• Configuration d’OpenCode

Détails techniques

wireApi: "responses" sélectionne /v1/responses ; wireApi: "chat-completions" sélectionne /v1/chat/completions. Les deux protocoles texte ont réussi lors du test de Qwen Code 0.26.0. Pour la lecture de fichiers, les taux de réussite étaient respectivement de 2/3 et 0/3.