Qwen Code API-kulcs: hol hozhatod létre, hogyan kapcsolhatod össze, és hogyan számíthatod ki a használatot

Valaki telepíti a Qwen Code-ot, elindítja a terminálban, és az első kérésnél máris kulcsot kér. Ezután kezdődik a keresés: az emberek beírják, hogy „buy api key for qwen code”, és olyan oldalakra jutnak, ahol előfizetést vagy valaki más kész hozzáférését árulják. Íme, mi ez a kulcs, hol szerezhető be, és mennyibe kerül, lépésről lépésre.

A lényeg rögtön az elején: senki sem árul API-kulcsot külön, dobozos termékként. Ez egy hozzáférési karakterlánc, amelyet te magad hozol létre a modell szolgáltatójánál vezetett fiókodban, és a létrehozása ingyenes. Később lesz szükséged pénzre, amikor feltöltöd az egyenlegedet; arra a lépésre a szolgáltató feltételei vonatkoznak. Az alábbiakban szó lesz arról, hol szerezhetsz kulcsot, hogyan kapcsolhatod össze a Qwen Code-dal, és mennyibe kerül a használata.

Pontosan mi a Qwen Code API-kulcsa?#

A Qwen Code egy nyílt forráskódú AI-ügynök, amely a terminálban fut, és kódot ír a feladataidhoz. Ingyenes, npm-en keresztül telepíthető, és nincs benne saját neurális hálózat. Az összes intelligens munkát a modell végzi, amely a szolgáltató szerverein fut.

A Qwen Code-nak belépőre van szüksége a modell eléréséhez. Ez a belépő az API-kulcs: egy hosszú, jelszószerű karakterlánc, amelyet a szolgáltató személyesen neked hoz létre. Amikor az ügynök elküld egy kérést, mellékeli a kulcsot; a szolgáltató ennek alapján azonosítja, kihez tartozik a kérés, válaszol, majd levonja a használat díját az egyenlegedből.

Ebből következik egy egyszerű megállapítás, amely a félreértések nagy részét tisztázza. A kulcsot nem piactéri termékként vásárolod meg: fiókot hozol létre egy szolgáltatónál, rákattintasz a „kulcs létrehozása” gombra, és ingyen megkapod a karakterláncot. A „buy api key” keresés valójában arra irányul, hogy „hol hozzak létre fiókot, és hogyan fizessek később a használatért”; az alábbiakban mindkét kérdésre kitérünk.

Miben különbözik az API-kulcs az előfizetéstől és a korábbi ingyenes bejelentkezéstől?#

A Qwen Code-on belüli /auth a telepített verzió által támogatott hitelesítési lehetőségeket mutatja. A kulcsot kiadó platformnak és annak számlázási csomagjának megfelelő bejegyzést válaszd. Az alábbi megkülönböztetés a régi ingyenes belépést, a Coding Plant és az itt használt standard API-kulcsot magyarázza, nem a mai menü teljes felsorolása.

Az első lehetőség az ingyenes bejelentkezés Qwen-fiókkal (Qwen OAuth). Korábban kulcs nélkül biztosított hozzáférést a modellhez, de megszüntették.

A második lehetőség az Alibaba ModelStudio Coding Plan-előfizetése. Fix havi díjas, heti kérési kvótát biztosít, és külön kapcsolódási címet használ.

A harmadik lehetőség egy modell szolgáltatójától származó API-kulcs. Nincs fix díj: feltöltöd az egyenlegedet, és munka közben, tokenfogyasztás alapján használod fel. Ez a lehetőség rugalmas, és akkor megfelelő, ha rendszertelenül használod az ügynököt. A cikk további része erről szól.

Hol hozhatsz létre API-kulcsot a Qwen Code-hoz?#

Mivel a Qwen Code többféle protokollt ismer, nem korlátozódsz egyetlen kulcsszolgáltatóra. A hivatalos dokumentáció kifejezetten felsorolja azokat a szolgáltatásokat, amelyekhez csatlakozni tud.

Az alábbiakban a közvetlen kapcsolódási útvonal következik.

A közvetlen kapcsolathoz nyisd meg az Alibaba Model Studio konzolját, válaszd ki a kívánt régiót, majd az API-kulcsok kezelőoldalán hozz létre kulcsot. A konfiguráció mellett őrizd meg a régió és a munkaterület nevét; a kulcsot ne másold megosztott jegyzetbe.

A régiós útmutató éles használatra munkaterület-specifikus tartományokat javasol. A valódi API Host értéket a Workspace Management felületéről másold, és kövesd az alap-URL útmutatóját; ne találj ki munkaterület-azonosítót. A meglévő közös DashScope-végpontok és a munkaterület-specifikus végpontok eltérő hozzáférési lehetőségek. A Coding Plan és a Token Plan is saját végpontot és kulcsot használ. A kiválasztott régió munkaterületének konzoljából másold a teljes OpenAI-kompatibilis alap-URL-t a DASHSCOPE_BASE_URL változóba. A JSON kihagyja a baseUrl mezőt; indítás előtt az OPENAI_BASE_URL adja meg a címet. Valódi konzolértékeket használj, ne munkaterület-helyőrzőt.

Van egy ingyenes lehetőség is, amelyhez nem kell kulcs: futtass egy Qwen-modellt a számítógépeden az Ollama segítségével, és csatlakoztasd hozzá a Qwen Code-ot saját szerverként. Ehhez nagy teljesítményű gép és külön beállítás szükséges. Az ügynök helyi futtatását a Qwen Code terminálban történő elindításáról szóló útmutató mutatja be.

Hogyan adhatod hozzá a kulcsot a Qwen Code-hoz, hogy működjön?#

Mentsd a meglévő beállításokat, és az alábbi kapcsolatot olvaszd be a ~/.qwen/settings.json fájlba; ne írd felül a többi szolgáltatót vagy beállítást. A szemléltető konfiguráció a Qwen Code hitelesítési példáját követi úgy, hogy a munkaterület URL-jét az OPENAI_BASE_URL adja át, az API-kulcsot az envKey által megnevezett környezeti változóból olvassa be, és a nyílt szövegű env blokk kimarad. A qwen3-coder-plus a hivatalos példa modellje; előbb ellenőrizd, hogy a kiválasztott régiód/fiókod kínálja-e, vagy mindkét helyen a régió konzoljából származó valódi modellazonosítót használd.

A kiválasztott régió munkaterületének konzoljából másold a teljes OpenAI-kompatibilis alap-URL-t a DASHSCOPE_BASE_URL változóba. A JSON kihagyja a baseUrl mezőt; indítás előtt az OPENAI_BASE_URL adja meg a címet. Valódi konzolértékeket használj, ne munkaterület-helyőrzőt.

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

Az openai a kompatibilis protokollt választja ki. Az envKey annak a változónak a neve, amelyet a Qwen Code olvas, nem a kulcs értéke. A model.name egyezzen a beállított id értékével. A mezőket a modellszolgáltatók referenciája dokumentálja.

macOS-en vagy Linuxon nyiss Bash-terminált, a rejtett bevitelnél add meg a kulcsot, majd ugyanabban a terminálban indítsd a Qwen Code-ot:

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

Windowson használj PowerShellt:

$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

Ezekkel a parancsokkal a titkos érték nem kerül a JSON-ba és a shell parancselőzményeibe; a futó folyamat a környezetén keresztül továbbra is megkapja. Ne írasd ki, ne commitold és ne illeszd promptba. E megoldásra áttérve távolítsd el a régi, titkot tartalmazó env bejegyzést. Új terminálban újra meg kell adni a változót.

A Qwen Code-ban a /doctor paranccsal vizsgáld a hitelesítést, a /model paranccsal pedig a beállított választást. Egy ártalmatlan, üres tesztmappában küldd ezt: „Válaszolj a connected szóval. Ne olvass vagy módosíts fájlokat, és ne futtass parancsokat.” A sikeres válasz egy modellkérést ellenőriz, amely használati díjjal járhat. A modell megjelenése a /model listájában csak a helyi konfigurációt igazolja.

Ha a kérés sikertelen, őrizd meg a titkoktól megtisztított hibát és a kapott kérésazonosítót. A hitelesítést külön ellenőrizd a modellelérhetőségtől és a számlázástól: ugyanannak a szolgáltatónak a konzoljában vizsgáld a kulcsot kiadó platformot, a régiót/munkaterületet, a standard vagy csomaghoz tartozó végpontot, a kiválasztott modellazonosítót és az egyenleget/kvótát. A 401-es hiba kulcs/végpont vagy számlázási csomag eltérését is jelezheti; nem bizonyítja, hogy a szolgáltató hibás. A sikertelen ellenőrzés után állj meg, és az újabb próba előtt javítsd a dokumentált eltérést. A cikk dokumentáción alapuló példát ír le, nem az útmutatóhoz végrehajtott fizetős kérést.

Mennyibe kerül az API-kulcs használata, és mitől nő a számla?#

A kulcs abban különbözik az előfizetéstől, hogy nincs fix havi díj. Azért fizetsz, amit a modell elolvas és megír, tokenekben mérve. A token egy nagyjából néhány betű hosszúságú szövegrész. Minden modellnek saját ára van egymillió bemeneti és egymillió kimeneti tokenre; a kimenet szinte mindig többe kerül, mint a bemenet.

Egymillió token soknak hangzik, de egy nagy projekten dolgozva gyorsabban elfogy, mint gondolnád: az ügynök minden kérésnél teljes egészében beolvassa a fájljaidat.

A gyakorlati tanulság: a számla attól függ, mennyi szöveget dolgoz fel az ügynök. A hosszú fájlok, a hosszú munkamenetek és a kód folyamatos újbóli beolvasása fogyasztja leggyorsabban az egyenlegedet; a feladatok száma másodlagos. Egy külön cikk lépésről lépésre elmagyarázza, hogyan számítják ki az API-tokenek használatát, és miért fogyhatnak el észrevétlenül.

Miért utasítják el a fizetést?#

Itt történik egy gyakori hiba.

Az akadály csak egy lépéssel később jelentkezik. Létrehoztad a kulcsot, de ha nincs pénz az egyenlegeden, semmit sem tudsz vele felhasználni — a szolgáltató insufficient funds hibát ad vissza.

Ha az elutasítás a kártyát kibocsátó bankhoz kapcsolódik, az e-mail-címed, a felület nyelvének vagy a profilbeállításaidnak a megváltoztatása nem módosítja a fizetési feltételeket. A mechanizmust a Claude-hoz használt külföldi kártya példáján keresztül ismertetjük.

Ne feledd, hogy a végső döntést a fizetési átjáró hozza meg. Saját okokból elutasíthatja a fizetést, és nincs garancia arra, hogy az átmegy.

Hol érdemes kezdened?#

Rövid, lépésről lépésre követhető terv:

1. A platformod és csomagod hitelesítési módjait különböztesd meg. A régi ingyenes Qwen OAuth-csomag 2026 áprilisában megszűnt; a Coding Plan és a standard Model Studio API eltérő számlázási mód. Ez az útmutató a standard, használatarányos API-kulcsot használja.
2. Hozz létre fiókot egy szolgáltatónál. A legegyszerűbb lehetőség a közvetlen Alibaba-hozzáférés.
3. Hozz létre kulcsot a szolgáltatói fiókod hozzáférési kulcsok részében. A létrehozása ingyenes; ehhez nem kell bankkártya.
4. A régiós kapcsolatot titkos érték nélkül olvaszd be a ~/.qwen/settings.json fájlba. A DASHSCOPE_API_KEY értékét az indító terminálban add meg, majd a fentiek szerint ellenőrizd a kiválasztott modellt és egy rövid választ.
5. A használat kifizetéséhez olyan kártyára van szükséged, amelyet a te nevedre állítottak ki, és amelyet elfogad a szolgáltató fizetési átjárója. A feltöltés feltételeit a fizetési átjáró határozza meg; a kulcs létrehozása és a használat kifizetése két külön lépés.

Azt is érdemes átgondolni, melyik modellre van szükséged. Igényes feladatokhoz válaszd a felső kategóriás Qwen3-Coder-Plus modellt; takarékoskodáshoz válaszd a könnyebb Flash modellt, amely azonos mennyiség mellett többszörösen olcsóbb. A Qwen Code mint a Claude Code helyettesítője című útmutató bemutatja, miben különbözik a Qwen Code más terminálos ügynököktől.

További anyagok az Ailoot oldalon érhetők el.