# Qwen Code API-kulcs: hol hozhatod létre, hogyan kapcsolhatod össze, és hogyan számíthatod ki a használatot > Mi az a Qwen Code API-kulcs, miben különbözik az előfizetéstől, hol lehet létrehozni, hogyan kell konfigurálni a settings.json fájlt, és mi határozza meg a tokenhasználatot. Source: https://ailoot.ai/blog/hu/qwen-code-api-key/ Canonical: https://ailoot.ai/blog/hu/qwen-code-api-key/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-141 Revision: sha256-7c1d0bafd12d4f92e9586e76c53fba00ce4847eda08623eef0c485075439678d 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.
Figyelem Ez az anyag tájékoztató jellegű, és nyilvános szabályokat ismertet. Nem nevez meg olyan közvetítő szolgáltatásokat, amelyek a korlátozások megkerülésével kínálnak fizetési „ügyintézést”, és nem ismertet módszereket a korlátozások megkerülésére. Az árak a szolgáltatók oldalairól származnak, 2026 szeptemberének eleji állapot szerint; változhatnak, ezért az aktuális árakat ellenőrizd a szolgáltató webhelyén.
[Ailoot-dokumentáció](https://ailoot.ai/docs/) — referenciaanyagok a szolgáltatás használatáról.
## Pontosan mi a Qwen Code API-kulcsa?
Lényeg A Qwen Code API-kulcsa egy személyes, jelszószerű karakterlánc, amellyel a szolgáltató azonosítja a modellnek küldött kéréseidet, és kiszámítja azok használatát. Maga a Qwen Code ingyenes, nyílt forráskódú ügynök; nincs saját beépített modellje. Külső szolgáltatótól kapja a válaszokat, és ott használja a kulcsodat. Tehát a „kulcsszerzés” azt jelenti, hogy regisztrálsz egy szolgáltatónál, és létrehozol egy hozzáférési karakterláncot a fiókodban. A Qwen Code-ban a kulcs változónevét állítsd be, a titkos értéket pedig az indító terminálban add meg; a kapcsolat használata előtt ellenőrizz egy modellválaszt.
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?
Lényeg A Qwen Code több hitelesítési és számlázási módot támogat. A régi ingyenes Qwen OAuth-csomagot 2026. április 15-én megszüntették. Az Alibaba Coding Plan előfizetést és saját végpontot használ; a standard Model Studio API-kulcs használatarányos számlázással működik. A jelenlegi kliensek további platform- és csomagválasztásokat is kínálnak. Ez az útmutató a standard Model Studio API-kulcsot tárgyalja: tartsd összhangban a régiót, a végpontot, a modellt és a számlázási csomagot.
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.

Az ingyenes Qwen OAuth-csomag 2026. április 15-i hatállyal megszűnt. A korábban mentett tokenek még működhetnek egy ideig, de az új kéréseket elutasítják.

— Qwen Code dokumentáció, Hitelesítés, hivatalos dokumentáció
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?
Lényeg A Qwen Code több szolgáltatóhoz és protokollhoz csatlakozhat. Közvetlen Alibaba Model Studio-kapcsolatnál a kulcs létrehozása előtt válaszd ki a régiót a Model Studio konzoljában. A kulcsnak, az API alap-URL-jének, a munkaterületnek és az elérhető modellnek ehhez a régióhoz kell tartoznia. A nemzetközi konzol címe vagy az angol felület önmagában nem határozza meg az API-régiót.
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.

Támogatja az OpenAI, az Anthropic, a Gemini és a Qwen protokollját. Bármely külső szolgáltató vagy helyi modell használható. Váltás menet közben.

— Qwen Code dokumentáció, Hitelesítés, hivatalos dokumentáció
Az alábbiakban a közvetlen kapcsolódási útvonal következik. A közvetlen kapcsolathoz nyisd meg az [Alibaba Model Studio konzolját](https://modelstudio.console.alibabacloud.com/), 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 kulcshoz kiválasztott régió | Standard OpenAI-kompatibilis alap-URL | Mit ellenőrizz? | |----|----|----| | Kína (Peking) | `DASHSCOPE_BASE_URL` | Pekingi kulcs és az ott elérhető modell | | Szingapúr | `DASHSCOPE_BASE_URL` | Szingapúri kulcs és az ott elérhető modell | | USA (Virginia), Global vagy US telepítési hatókörrel is | Másold ki a kiválasztott amerikai munkaterület API Host értékét, és használd a dokumentált OpenAI-kompatibilis alap-URL-jét | Amerikai munkaterületkulcs, telepítési hatókör és modelllista; ne használd újra a pekingi vagy szingapúri címet | A [régiós útmutató](https://www.alibabacloud.com/help/en/model-studio/regions) é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](https://www.alibabacloud.com/help/en/model-studio/base-url); 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ó](https://ailoot.ai/blog/hu/qwen-code-terminal-auto-edit/) mutatja be. ## Hogyan adhatod hozzá a kulcsot a Qwen Code-hoz, hogy működjön?
Lényeg A `~/.qwen/settings.json` fájlban a protokollt, a régióhoz tartozó alap-URL-t, a modellazonosítót és az `envKey` értéket állítsd be: ez a kulcsot szolgáltató környezeti változó neve. A titkos értéket ne írd ebbe a JSON-ba. Abból a terminálból indítsd a Qwen Code-ot, amelyben a változó elérhető, ellenőrizd a kiválasztott kapcsolatot, és küldj egy rövid promptot, mielőtt használhatónak tekinted. A `/model` a beállított lehetőségeket listázza; önmagában nem bizonyít szolgáltatói hozzáférést.
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](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) 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. ```json { "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](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/) 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: ```bash 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: ```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 ``` 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?
Lényeg API-kulccsal fogyasztás szerint fizetsz: minden ezer bemeneti és kimeneti tokennek külön ára van, fix havi díj nélkül. A könnyebb modellek, például a Qwen3-Coder-Flash, többszörösen olcsóbbak. A számla a munkamennyiséggel nő: minél hosszabbak a fájljaid, és minél többet olvas és ír az ügynök, annál nagyobb a felhasználás. A pontos árért mindig ellenőrizd a szolgáltató oldalát; az ár változik.
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](https://ailoot.ai/blog/hu/api-token-usage-calculation/), és miért fogyhatnak el észrevétlenül. ## Miért utasítják el a fizetést?
Lényeg Ahhoz, hogy a kulcs terhére használhasd a szolgáltatást, fel kell töltened az egyenlegedet. Ha a fizetési rendszer a kártyát kibocsátó bank miatt utasítja el a kártyádat, az e-mail-címed, a nyelved vagy a profilbeállításaid megváltoztatása nem módosítja a kártya feltételeit.
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](https://ailoot.ai/blog/hu/claude-card-payment-requirements/) 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?
Lényeg Kezdd a hitelesítési és számlázási módok elkülönítésével: a régi ingyenes Qwen OAuth-csomag megszűnt, a Coding Plan előfizetést és saját végpontot használ, ez az útmutató pedig standard, használatarányos Model Studio API-kulccsal dolgozik. A kiválasztott régióban és munkaterületen ingyen hozd létre a kulcsot, a konfigurációba a változónevét írd, a titkot pedig a terminálban add meg. Az egyenleg feltöltéséhez olyan kártyára van szükséged, amelyet elfogad a fizetési átjáró. Ha alacsonyan szeretnéd tartani a fogyasztást, válassz könnyebb modellt.
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](https://ailoot.ai/blog/hu/qwen-code-token-plan-setup/) című útmutató bemutatja, miben különbözik a Qwen Code más terminálos ügynököktől.
### Források - [Qwen Code - GitHub-tárház](https://github.com/QwenLM/qwen-code) - nyílt forráskódú ügynökkód, telepítés, többprotokollos támogatás és külső szolgáltatókhoz való csatlakozás - [Qwen Code - hitelesítési dokumentáció](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - verziófüggő hitelesítési lehetőségek, az ingyenes OAuth megszüntetése 2026.04.15-én és a kapcsolat beállítása titkos érték nélkül - [Alibaba Model Studio — konzol és régióválasztás](https://modelstudio.console.alibabacloud.com/) - a kulcs létrehozása előtt válassz régiót és munkaterületet; az alap-URL és a modell ehhez tartozzon
További anyagok az [Ailoot](https://ailoot.ai/) oldalon érhetők el. ## Kérdések és válaszok: Qwen Code API-kulcs: hol hozhatod létre, hogyan kapcsolhatod össze, és hogyan számíthatod ki a használatot ### Az API-kulcs kiadása ugyanaz, mint modellhasználat vásárlása? Nem. A hozzáférési karakterlánc kiadása különbözik a használat finanszírozásától. A szolgáltató a kulccsal azonosítja és méri a kéréseket; a kiadott kulcs önmagában nem igazol használható egyenleget vagy kvótát. ### Minek kell egyeznie a Qwen Code szolgáltatóbeállításában? A választott protokollnak, szolgáltatói base URL-nek, kulcsot tartó környezeti változónak és modellazonosítónak ugyanarra a kapcsolatra kell utalnia. A példában a model.name egyezik a modelProviders bejegyzés id értékével; a tényleges kulcs ne kerüljön megosztott beállításmásolatba. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.