Qwen Code API-sleutel: aanmaken, koppelen en verbruik berekenen

Iemand installeert Qwen Code, start het in de terminal en bij het allereerste verzoek vraagt het om een sleutel. Dan begint de zoektocht: mensen zoeken op “buy api key for qwen code” en komen terecht op pagina’s waar ze een abonnement of kant-en-klare toegang van iemand anders aangeboden krijgen. Hier lees je stap voor stap wat de sleutel is, waar je die kunt krijgen en wat die kost.

Eerst het belangrijkste: een API-sleutel wordt niet als een afzonderlijk product in een doos verkocht. Het is een toegangscode die je zelf aanmaakt in het account bij de modelprovider, en het aanmaken ervan is gratis. Pas later heb je geld nodig om je saldo op te waarderen; dan gelden de voorwaarden van de provider. Hieronder lees je waar je een sleutel kunt krijgen, hoe je die met Qwen Code verbindt en wat het gebruik kost.

Wat is een API-sleutel voor Qwen Code precies?#

Qwen Code is een open-source-AI-agent die in de terminal draait en code schrijft voor je taken. Hij is gratis, wordt via npm geïnstalleerd en bevat zelf geen neuraal netwerk. Het model doet al het denkwerk en draait op de servers van de provider.

Qwen Code heeft toegang nodig tot het model. Die toegang is de API-sleutel: een lange tekenreeks, vergelijkbaar met een wachtwoord, die de provider persoonlijk aan jou verstrekt. Wanneer de agent een verzoek verstuurt, voegt hij de sleutel eraan toe; de provider gebruikt die om vast te stellen van wie het verzoek komt, stuurt een antwoord terug en brengt het gebruik in rekening op je saldo.

Dit leidt tot een eenvoudig punt dat de helft van de verwarring wegneemt. Je koopt een sleutel niet als product op een marktplaats: je maakt een account aan bij een provider, klikt op “sleutel aanmaken” en krijgt de tekenreeks gratis. De zoekopdracht “buy api key” betekent eigenlijk “waar maak ik een account aan en hoe betaal ik daarna voor het gebruik?”, en hieronder beantwoorden we beide vragen.

Waarin verschilt een API-sleutel van een abonnement en de oude gratis aanmelding?#

Binnen Qwen Code toont /auth de authenticatiekeuzes die je geïnstalleerde versie ondersteunt. Kies de optie voor het platform dat je sleutel heeft uitgegeven en het bijbehorende betaalplan. Hieronder onderscheiden we de oude gratis aanmelding, Coding Plan en de standaard-API-sleutel uit deze gids; dit is geen volledige lijst van de huidige menukeuzes.

De eerste optie is gratis aanmelden via een Qwen-account (Qwen OAuth). Daarmee kreeg je vroeger toegang tot het model zonder sleutel, maar deze optie is stopgezet.

De tweede optie is het Coding Plan-abonnement van Alibaba ModelStudio. Je betaalt een vast maandbedrag en krijgt een wekelijks verzoekquotum en een afzonderlijk verbindingsadres.

De derde optie is de API-sleutel van een modelprovider. Er is geen vast bedrag: je zet geld op je saldo en verbruikt het tijdens het werken op basis van de tokenmeter. Deze optie is flexibel en geschikt als je de agent onregelmatig gebruikt. De rest van dit artikel gaat hierover.

Waar kun je een API-sleutel voor Qwen Code aanmaken?#

Omdat Qwen Code verschillende protocollen begrijpt, ben je niet beperkt tot één sleutelprovider. In de officiële documentatie staan de diensten waarmee het verbinding kan maken expliciet vermeld.

Hieronder staat de directe verbindingsoptie.

Open voor de directe route de Alibaba Model Studio-console, kies de gewenste regio en maak op de bijbehorende API-sleutelpagina een sleutel aan. Bewaar regio en workspacenaam bij de configuratie; kopieer de sleutel niet naar gedeelde notities.

De regiogids beveelt eigen workspacedomeinen aan voor productie. Kopieer de werkelijke API Host uit Workspace Management en volg de basis-URL-gids; verzin geen workspace-ID. Gedeelde DashScope-eindpunten en eigen workspace-eindpunten zijn verschillende toegangskeuzes. Coding Plan en Token Plan gebruiken eveneens eigen eindpunten en sleutels. Kopieer de volledige OpenAI-compatibele basis-URL uit de console van je workspace in de gekozen regio naar DASHSCOPE_BASE_URL. JSON laat baseUrl weg; vóór de start geef je het adres door via OPENAI_BASE_URL. Gebruik echte consolewaarden, geen tijdelijke workspace-ID.

Er is ook een gratis optie waarvoor je geen sleutel nodig hebt: start een Qwen-model op je computer via Ollama en verbind Qwen Code ermee als je eigen server. Daarvoor heb je een krachtige computer en een afzonderlijke configuratie nodig. Hoe je de agent lokaal start, staat in de handleiding over Qwen Code starten in de terminal.

Hoe voeg je de sleutel toe aan Qwen Code zodat die werkt?#

Maak een back-up van de bestaande instellingen en voeg de onderstaande verbinding samen met ~/.qwen/settings.json; overschrijf geen andere providers of voorkeuren. Deze configuratie volgt het Qwen Code-authenticatievoorbeeld met de workspace-URL via OPENAI_BASE_URL, de API-sleutel uit de omgevingsvariabele die envKey noemt en zonder het blok env met het geheim in platte tekst. qwen3-coder-plus is het model uit dat officiële voorbeeld. Controleer eerst of je regio en account het aanbieden, of gebruik op beide plaatsen een werkelijke model-ID uit de console van die regio.

Kopieer de volledige OpenAI-compatibele basis-URL uit de console van je workspace in de gekozen regio naar DASHSCOPE_BASE_URL. JSON laat baseUrl weg; vóór de start geef je het adres door via OPENAI_BASE_URL. Gebruik echte consolewaarden, geen tijdelijke workspace-ID.

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

openai kiest het compatibele protocol. envKey noemt de variabele die Qwen Code leest, niet de geheime waarde. model.name moet overeenkomen met de ingestelde id. Deze velden staan in de modelproviderreferentie.

Open op macOS of Linux een Bash-terminal, voer de sleutel onzichtbaar in en start Qwen Code vanuit diezelfde 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

Gebruik op Windows 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

Deze opdrachten houden de geheime waarde uit JSON en de opdrachtgeschiedenis; het draaiende proces ontvangt haar nog steeds via zijn omgeving. Print de sleutel niet, commit hem niet en plak hem niet in een prompt. Verwijder bij deze werkwijze een oude env-instelling met de geheime waarde. In een nieuwe terminal moet je de variabele opnieuw opgeven.

Bekijk in Qwen Code met /doctor de authenticatie en met /model de ingestelde keuze. Stuur in een onschuldige lege testmap: “Antwoord met het woord verbonden. Lees of wijzig geen bestanden en voer geen opdrachten uit.” Een geslaagd antwoord test één modelverzoek en kan gebruikskosten opleveren. Dat een model in /model staat, bevestigt alleen de lokale configuratie.

Noteer bij een fout de opgeschoonde melding en een eventuele verzoek-ID. Controleer authenticatie apart van modelbeschikbaarheid en facturering: uitgevend platform, regio/workspace, standaard- of abonnementseindpunt, model-ID en saldo/quotum moeten in dezelfde providerconsole kloppen. Een 401 kan wijzen op een sleutel-/eindpunt- of betaalplanverschil; het bewijst niet dat de provider defect is. Stop na de mislukte controle en herstel het gedocumenteerde verschil voordat je opnieuw probeert. Deze gids beschrijft een documentatievoorbeeld, geen hiervoor uitgevoerd betaald verzoek.

Wat kost werken met een API-sleutel en waardoor loopt de rekening op?#

Een sleutel verschilt van een abonnement doordat er geen vast maandbedrag is. Je betaalt voor wat het model leest en schrijft, gemeten in tokens. Een token is een stukje tekst van ongeveer een paar letters. Elk model heeft een eigen prijs per miljoen invoertokens en per miljoen uitvoertokens; uitvoer kost vrijwel altijd meer dan invoer.

Een miljoen tokens klinkt als veel, maar bij het werken aan een groot project gaat het sneller dan je zou verwachten: de agent leest bij elk verzoek je bestanden volledig door.

De praktische conclusie: de rekening hangt af van de hoeveelheid tekst die de agent verwerkt. Lange bestanden, lange sessies en code steeds opnieuw lezen verbruiken je saldo het snelst; het aantal taken is van ondergeschikt belang. Een apart artikel legt stap voor stap uit hoe het API-tokenverbruik wordt berekend en waarom je saldo ongemerkt kan opraken.

Waarom worden betalingen geweigerd?#

Hier gaat het vaak mis.

De hindernis komt een stap later. Je hebt de sleutel aangemaakt, maar zonder geld op je saldo wordt er niets mee verbruikt: de provider geeft een melding dat er onvoldoende saldo is.

Als de weigering verband houdt met de bank die de kaart heeft uitgegeven, veranderen aanpassingen van je e-mailadres, interfacetaal of profielinstellingen niets aan de betalingsvoorwaarden. Dit mechanisme wordt uitgelegd aan de hand van een buitenlandse kaart voor Claude.

Houd er ook rekening mee dat de betalingsgateway de uiteindelijke beslissing neemt. Die kan de betaling om eigen redenen weigeren; er is geen garantie dat de betaling wordt geaccepteerd.

Waar begin je?#

Een kort stappenplan:

1. Controleer platform, regio/workspace en betaalplan van je sleutel en de authenticatiekeuzes van de geïnstalleerde versie. Deze gids gebruikt standaard Model Studio-betaling naar gebruik; Coding Plan en andere plannen hebben eigen eindpunten en sleutels.
2. Maak een account aan bij een provider. De eenvoudigste optie is Alibaba rechtstreeks.
3. Maak een sleutel aan in het provideraccount, bij de toegangssleutels. Dat is gratis; je hebt er geen kaart voor nodig.
4. Voeg de regionale verbinding zonder geheime waarde samen met ~/.qwen/settings.json. Geef DASHSCOPE_API_KEY op in de startende terminal en controleer de modelkeuze en één kort antwoord zoals hierboven.
5. Om voor het gebruik te betalen, heb je een kaart nodig die op jouw naam is uitgegeven en door de betalingsgateway van de provider wordt geaccepteerd. De betalingsgateway bepaalt de voorwaarden voor het opwaarderen; een sleutel aanmaken en voor gebruik betalen zijn afzonderlijke stappen.

Denk ook na over welk model je nodig hebt. Kies voor veeleisende taken het geavanceerdere Qwen3-Coder-Plus; kies de lichtere Flash om geld te besparen, want die is voor hetzelfde volume een paar keer goedkoper. De handleiding over Qwen Code als vervanging voor Claude Code laat zien waarin Qwen Code verschilt van andere terminalagents.

Meer materiaal is beschikbaar op Ailoot.