Clé API Qwen Code : où en créer une, la connecter et calculer l’utilisation

Quelqu’un installe Qwen Code, le lance dans le terminal et, dès la toute première requête, le programme demande une clé. La recherche commence alors : les gens tapent « buy api key for qwen code » et arrivent sur des pages où l’on vend soit un abonnement, soit l’accès prêt à l’emploi de quelqu’un d’autre. Voici ce qu’est cette clé, où l’obtenir et combien elle coûte, étape par étape.

Commençons par l’essentiel : personne ne vend une clé API comme un produit vendu séparément. C’est une chaîne d’accès que vous créez vous-même dans le compte du fournisseur du modèle, et sa création est gratuite. Vous aurez besoin d’argent plus tard, pour recharger votre solde ; les conditions du fournisseur s’appliquent à cette étape. Voici où obtenir une clé, comment la connecter à Qwen Code et combien son utilisation coûte.

Qu’est-ce qu’une clé API pour Qwen Code, exactement ?#

Qwen Code est un agent d’IA open source qui s’exécute dans le terminal et écrit du code pour vos tâches. Il est gratuit, s’installe via npm et ne contient aucun réseau neuronal qui lui soit propre. Tout le travail intelligent est effectué par le modèle, qui tourne sur les serveurs du fournisseur.

Qwen Code a besoin d’un laissez-passer pour accéder au modèle. Ce laissez-passer est la clé API : une longue chaîne semblable à un mot de passe, que le fournisseur crée spécialement pour vous. Lorsque l’agent envoie une requête, il y joint la clé ; le fournisseur s’en sert pour identifier l’auteur de la requête, répond, puis déduit l’utilisation de votre solde.

Cela mène à un constat simple qui dissipe la moitié de la confusion. Une clé ne s’achète pas sur une place de marché : vous créez un compte auprès d’un fournisseur, cliquez sur « créer une clé » et obtenez gratuitement la chaîne. La recherche « buy api key » signifie en réalité : « Où créer un compte et comment payer ensuite l’utilisation ? » Les deux questions sont abordées ci-dessous.

En quoi une clé API diffère-t-elle d’un abonnement et de l’ancienne connexion gratuite ?#

Dans Qwen Code, /auth affiche les modes d’authentification pris en charge par la version installée. Choisissez la plateforme qui a émis votre clé et son offre de facturation. Les distinctions ci-dessous expliquent l’ancien accès gratuit, Coding Plan et la clé API standard utilisée ici ; elles ne constituent pas une liste exhaustive du menu actuel.

La première option est la connexion gratuite via un compte Qwen (Qwen OAuth). Elle permettait auparavant d’accéder au modèle sans clé, mais a été interrompue.

La deuxième option est l’abonnement Coding Plan d’Alibaba ModelStudio. Il s’agit d’un montant mensuel fixe qui vous donne droit à un quota hebdomadaire de requêtes et à une adresse de connexion distincte.

La troisième option est la clé API d’un fournisseur de modèles. Il n’y a pas de frais fixes : vous créditez votre solde et le dépensez au fur et à mesure, selon le nombre de jetons utilisés. Cette option est flexible et vous convient si vous utilisez l’agent de façon irrégulière. Le reste de cet article porte sur cette option.

Où créer une clé API pour Qwen Code ?#

Comme Qwen Code comprend plusieurs protocoles, vous n’êtes pas limité à un seul fournisseur de clés. La documentation officielle énumère explicitement les services auxquels il peut se connecter.

Voici la méthode de connexion directe.

Pour l’accès direct, ouvrez la console Alibaba Model Studio, sélectionnez la région voulue et créez une clé dans la gestion des clés API. Conservez la région et le nom du workspace avec la configuration ; ne copiez pas la clé dans des notes partagées.

Le guide des régions recommande les domaines dédiés au workspace en production. Copiez l’API Host réel depuis Workspace Management et suivez le guide des Base URL ; n’inventez pas d’identifiant de workspace. Les endpoints DashScope partagés et ceux dédiés aux workspaces sont des choix distincts. Coding Plan et Token Plan ont aussi leurs propres endpoints et clés. Copiez la Base URL complète compatible OpenAI depuis la console du workspace de la région choisie dans DASHSCOPE_BASE_URL. Le JSON omet baseUrl ; l’adresse est fournie par OPENAI_BASE_URL avant le lancement. Utilisez les valeurs réelles de la console, jamais un identifiant fictif.

Il existe aussi une option gratuite qui ne nécessite aucune clé : exécuter un modèle Qwen sur votre ordinateur avec Ollama et connecter Qwen Code à celui-ci comme à votre propre serveur. Il faut une machine puissante et une configuration distincte. Le guide sur le lancement de Qwen Code dans le terminal explique comment exécuter l’agent localement.

Comment ajouter la clé à Qwen Code pour qu’elle fonctionne ?#

Sauvegardez les paramètres existants et fusionnez la connexion ci-dessous dans ~/.qwen/settings.json sans écraser les autres fournisseurs ni préférences. Cette configuration illustrative suit l’exemple d’authentification Qwen Code avec l’URL du workspace transmise via OPENAI_BASE_URL, la clé API lue dans la variable d’environnement désignée par envKey et sans bloc env contenant le secret en clair. qwen3-coder-plus est le modèle de cet exemple officiel ; vérifiez sa disponibilité dans votre région et votre compte, ou utilisez dans les deux champs un identifiant réel de la console régionale.

Copiez la Base URL complète compatible OpenAI depuis la console du workspace de la région choisie dans DASHSCOPE_BASE_URL. Le JSON omet baseUrl ; l’adresse est fournie par OPENAI_BASE_URL avant le lancement. Utilisez les valeurs réelles de la console, jamais un identifiant fictif.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai sélectionne le protocole compatible. envKey nomme la variable lue par Qwen Code ; ce n’est pas la valeur de la clé. model.name doit correspondre à l’id configuré. La référence des fournisseurs documente ces champs.

Sur macOS ou Linux, ouvrez un terminal Bash, saisissez la clé dans l’invite masquée, puis lancez Qwen Code dans ce même terminal :

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

Sous Windows, utilisez PowerShell :

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

Ces commandes gardent le secret hors du JSON et de l’historique des commandes ; le processus le reçoit néanmoins dans son environnement. Ne l’affichez pas, ne le commitez pas et ne le collez pas dans un prompt. Supprimez l’ancienne entrée env contenant le secret en adoptant ce parcours. Il faut fournir à nouveau la variable dans un nouveau terminal.

Dans Qwen Code, utilisez /doctor pour l’authentification et /model pour vérifier le choix configuré. Dans un dossier de test vide et sans risque, envoyez : « Réponds par le mot connected. Ne lis ni ne modifie aucun fichier et n’exécute aucune commande. » Une réponse réussie teste une requête de modèle et peut être facturée. Un modèle présent dans /model ne confirme que la configuration locale.

En cas d’échec, notez l’erreur expurgée et l’identifiant de requête s’il est fourni. Distinguez l’authentification de la disponibilité du modèle et de la facturation : vérifiez plateforme émettrice, région/workspace, endpoint standard ou d’offre, identifiant du modèle et solde/quota dans la même console. Un 401 peut provenir d’une incompatibilité clé/endpoint ou d’offre ; il ne prouve pas une panne du fournisseur. Arrêtez après cet échec et corrigez l’écart documenté avant un autre essai. Cet article présente un exemple documentaire, pas une requête payante exécutée pour le guide.

Combien coûte l’utilisation d’une clé API et qu’est-ce qui fait augmenter la facture ?#

Une clé diffère d’un abonnement parce qu’elle n’entraîne aucun montant mensuel fixe. Vous payez ce que le modèle lit et écrit, mesuré en jetons. Un jeton est un fragment de texte de quelques lettres environ. Chaque modèle a son propre prix par million de jetons d’entrée et par million de jetons de sortie ; les jetons de sortie coûtent presque toujours plus cher que ceux d’entrée.

Un million de jetons, cela paraît beaucoup, mais lorsque vous travaillez sur un grand projet, ils s’épuisent plus vite que prévu : l’agent lit vos fichiers en entier à chaque requête.

En pratique, la facture dépend de la quantité de texte traitée par l’agent. Les fichiers longs, les longues sessions et la relecture constante du code consomment votre solde le plus rapidement ; le nombre de tâches est secondaire. Un article distinct explique étape par étape comment est calculée l’utilisation des jetons API et pourquoi votre solde peut diminuer à votre insu.

Pourquoi les paiements sont-ils refusés ?#

C’est ici qu’une erreur fréquente se produit.

Le problème survient à l’étape suivante. Vous avez créé la clé, mais sans argent sur le solde, elle ne pourra rien dépenser : le fournisseur renverra une erreur de fonds insuffisants.

Si le refus est lié à la banque qui a émis la carte, changer d’adresse e-mail, de langue d’interface ou de paramètres de profil ne modifie pas les conditions de paiement. Ce mécanisme est expliqué à l’aide de l’exemple d’une carte étrangère pour Claude.

Et n’oubliez pas que la décision finale appartient à la passerelle de paiement. Elle peut refuser le paiement pour ses propres raisons ; rien ne garantit qu’il sera accepté.

Par où commencer ?#

Voici un bref plan étape par étape :

1. Identifiez la plateforme et l’offre de facturation correspondant aux options d’authentification de votre client installé. L’ancien accès OAuth gratuit a été interrompu en avril 2026. Cette liste concerne une clé Model Studio standard avec paiement à l’usage ; les autres offres et plateformes ont leurs propres parcours documentés.
2. Créez un compte auprès d’un fournisseur. L’option la plus simple est Alibaba directement.
3. Créez une clé dans le compte du fournisseur, dans la section des clés d’accès. Sa création est gratuite ; vous n’avez pas besoin de carte pour cela.
4. Fusionnez la connexion régionale dans ~/.qwen/settings.json sans valeur secrète. Fournissez DASHSCOPE_API_KEY dans le terminal de lancement, puis vérifiez le modèle choisi et une courte réponse comme indiqué plus haut.
5. Pour payer l’utilisation, il vous faut une carte émise à votre nom et acceptée par la passerelle de paiement du fournisseur. La passerelle fixe les conditions de recharge ; créer une clé et payer l’utilisation sont deux étapes distinctes.

Il vaut aussi la peine de réfléchir au modèle dont vous avez besoin. Pour les tâches exigeantes, choisissez le modèle haut de gamme Qwen3-Coder-Plus ; pour économiser, optez pour le modèle Flash plus léger, plusieurs fois moins cher pour le même volume. Le guide sur Qwen Code comme remplacement de Claude Code montre en quoi Qwen Code diffère des autres agents de terminal.

D’autres ressources sont disponibles sur Ailoot.