Kľúč API Qwen Code: kde ho vystaviť, pripojiť a vypočítať spotrebu

Niekto si nainštaluje Qwen Code, spustí ho v termináli a hneď pri prvej požiadavke si vypýta kľúč. Potom sa začne hľadanie: ľudia zadávajú „buy api key for qwen code“ a dostanú sa na stránky, kde im predávajú buď predplatné, alebo hotový prístup niekoho iného. Tu sa krok za krokom dozviete, čo je kľúč, kde ho získať a koľko stojí.

Hneď na úvod hlavný bod: nikto nepredáva kľúč API ako samostatný produkt v krabičke. Je to prístupový reťazec, ktorý si sami vystavíte v účte poskytovateľa modelu, a jeho vystavenie je bezplatné. Peniaze budete potrebovať neskôr, keď si dobijete zostatok; v tomto kroku platia podmienky poskytovateľa. Nižšie sa dozviete, kde získať kľúč, ako ho pripojiť k Qwen Code a koľko stojí jeho používanie.

Čo presne je kľúč API pre Qwen Code?#

Qwen Code je AI agent s otvoreným zdrojovým kódom, ktorý beží v termináli a píše kód pre vaše úlohy. Je bezplatný, inštaluje sa cez npm a nemá v sebe vlastnú neurónovú sieť. Všetku inteligentnú prácu vykonáva model, ktorý beží na serveroch poskytovateľa.

Qwen Code potrebuje na prístup k modelu vstupenku. Touto vstupenkou je kľúč API — dlhý reťazec podobný heslu, ktorý vám poskytovateľ vystaví osobne. Keď agent odošle požiadavku, pripojí k nej kľúč; poskytovateľ ho použije na zistenie, komu požiadavka patrí, odpovie a odpočíta spotrebu z vášho zostatku.

Z toho vyplýva jednoduchý bod, ktorý objasňuje polovicu zmätku. Kľúč sa nekupuje ako produkt na trhovisku: vytvoríte si účet u poskytovateľa, kliknete na „vytvoriť kľúč“ a reťazec získate zadarmo. Vyhľadávanie „buy api key“ v skutočnosti znamená „kde si vytvorím účet a ako potom zaplatím za používanie“ a odpovede na obe otázky nájdete nižšie.

Ako sa kľúč API líši od predplatného a starého bezplatného prihlásenia?#

Príkaz /auth v Qwen Code zobrazuje možnosti overenia podporované nainštalovanou verziou. Vyberte položku pre platformu, ktorá vydala váš kľúč, a jej spôsob účtovania. Nasledujúce rozlíšenie vysvetľuje staré bezplatné prihlásenie, Coding Plan a štandardný kľúč API použitý v tomto návode; nie je to úplný zoznam dnešných položiek ponuky.

Prvou možnosťou je bezplatné prihlásenie cez účet Qwen (Qwen OAuth). Kedysi poskytovalo prístup k modelu bez kľúča, ale bolo ukončené.

Druhou možnosťou je predplatné Coding Plan služby Alibaba ModelStudio. Má pevnú mesačnú cenu, ktorá vám poskytuje týždenný limit požiadaviek a samostatnú adresu pripojenia.

Treťou možnosťou je kľúč API od poskytovateľa modelu. Nemá pevnú cenu: vložíte peniaze na zostatok a míňate ich počas práce podľa počítadla tokenov. Táto možnosť je flexibilná a hodí sa, ak agenta používate nepravidelne. Zvyšok článku sa venuje práve jej.

Kde môžete vystaviť kľúč API pre Qwen Code?#

Keďže Qwen Code rozumie rôznym protokolom, nie ste obmedzení na jediného poskytovateľa kľúča. Oficiálna dokumentácia výslovne uvádza služby, ku ktorým sa dokáže pripojiť.

Nižšie je opísaná cesta priameho pripojenia.

Pre priame pripojenie otvorte konzolu Alibaba Model Studio, vyberte zamýšľaný región a vytvorte kľúč na stránke správy kľúčov API. Názov regiónu a pracovného priestoru uchovajte pri konfigurácii; kľúč nekopírujte do zdieľaných poznámok.

Sprievodca regiónmi odporúča pre produkciu domény vyhradené pracovnému priestoru. Skopírujte skutočný API Host zo správy Workspace Management a postupujte podľa návodu na základné URL; nevymýšľajte ID pracovného priestoru. Existujúce zdieľané endpointy DashScope a endpointy vyhradené pracovnému priestoru sú odlišné možnosti prístupu. Coding Plan a Token Plan tiež používajú vlastné endpointy a kľúče. Z konzoly pracovného priestoru vo vybranom regióne skopírujte úplnú základnú URL kompatibilnú s OpenAI do DASHSCOPE_BASE_URL. JSON vynecháva baseUrl; pred spustením sa adresa odovzdá cez OPENAI_BASE_URL. Použite skutočné hodnoty z konzoly, nie zástupné ID priestoru.

Existuje aj bezplatná možnosť, ktorá nevyžaduje žiadny kľúč: spustite model Qwen na svojom počítači cez Ollama a pripojte k nemu Qwen Code ako k vlastnému serveru. Vyžaduje si to výkonný počítač a samostatné nastavenie. Návod na spustenie Qwen Code v termináli ukazuje, ako agenta spustiť lokálne.

Ako pridať kľúč do Qwen Code, aby fungoval?#

Zálohujte existujúce nastavenia a nasledujúce pripojenie zlúčte do ~/.qwen/settings.json; neprepisujte nesúvisiacich poskytovateľov ani preferencie. Táto ilustračná konfigurácia vychádza z príkladu overenia Qwen Code s URL pracovného priestoru odovzdanou cez OPENAI_BASE_URL, kľúčom API načítaným z premennej prostredia uvedenej v envKey a bez bloku env s kľúčom v obyčajnom texte. qwen3-coder-plus je model z oficiálneho príkladu; najprv overte, že ho vybraný región a účet ponúkajú, alebo na oboch miestach použite skutočné ID modelu z konzoly daného regiónu.

Z konzoly pracovného priestoru vo vybranom regióne skopírujte úplnú základnú URL kompatibilnú s OpenAI do DASHSCOPE_BASE_URL. JSON vynecháva baseUrl; pred spustením sa adresa odovzdá cez OPENAI_BASE_URL. Použite skutočné hodnoty z konzoly, nie zástupné ID priestoru.

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

openai vyberá kompatibilný protokol. envKey pomenúva premennú, ktorú Qwen Code číta; nie je to hodnota kľúča. model.name sa musí zhodovať s nastaveným id. Tieto polia dokumentuje referenčný prehľad poskytovateľov modelov.

V macOS alebo Linuxe otvorte terminál Bash, zadajte kľúč do skrytej výzvy a potom v tom istom termináli spustite Qwen Code:

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

Vo Windows použite 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

Tieto príkazy ponechávajú doslovný tajný kľúč mimo JSON a histórie príkazov; bežiaci proces ho stále dostáva vo svojom prostredí. Nevypisujte ho, neukladajte do repozitára ani nevkladajte do pokynu. Pri prechode na tento postup odstráňte z nastavení starú položku env obsahujúcu tajný kľúč. V novom termináli treba premennú dodať znova.

V Qwen Code použite /doctor na kontrolu overenia a /model na kontrolu vybraného nastavenia. V neškodnom prázdnom testovacom priečinku odošlite: „Odpovedz slovom connected. Nečítaj ani nemeň súbory a nespúšťaj príkazy.“ Úspešná odpoveď overuje jednu požiadavku na model a môže znamenať poplatok za spotrebu. Zobrazenie nastaveného modelu v /model potvrdzuje len lokálnu konfiguráciu.

Ak požiadavka zlyhá, zaznamenajte redigovanú chybu a ID požiadavky, ak ho poskytovateľ uviedol. Overenie kontrolujte oddelene od dostupnosti modelu a účtovania: v tej istej konzole poskytovateľa overte platformu vydania kľúča, región a pracovný priestor, štandardný endpoint oproti endpointu plánu, ID modelu aj zostatok a kvótu účtu. Chyba 401 môže znamenať nesúlad kľúča a endpointu alebo platobného plánu; nedokazuje poruchu poskytovateľa. Po neúspešnom teste zastavte a pred ďalším pokusom opravte zdokumentovaný nesúlad. Článok opisuje príklad podľa dokumentácie, nie platenú požiadavku vykonanú pre tento návod.

Koľko stojí práca s kľúčom API a čo zvyšuje účet?#

Kľúč sa od predplatného líši tým, že nemá pevnú mesačnú cenu. Platíte za to, čo model číta a zapisuje, merané v tokenoch. Token je časť textu dlhá približne niekoľko písmen. Každý model má vlastnú cenu za milión vstupných tokenov a za milión výstupných tokenov, pričom výstup takmer vždy stojí viac než vstup.

Milión tokenov znie ako veľa, ale pri práci na veľkom projekte sa minú rýchlejšie, než by ste čakali: agent pri každej požiadavke prečíta vaše súbory celé.

Praktický záver je takýto. Účet závisí od množstva textu, ktoré agent spracuje. Dlhé súbory, dlhé relácie a neustále opätovné čítanie kódu spotrebujú zostatok najrýchlejšie; počet úloh je druhoradý. Samostatný článok krok za krokom vysvetľuje, ako sa počíta spotreba tokenov API a prečo sa môže nenápadne míňať.

Prečo sa platby zamietajú?#

Práve tu dochádza k častej chybe.

Prekážka sa objaví až o krok neskôr. Kľúč ste si vystavili, ale bez peňazí na zostatku nič neminie — poskytovateľ vráti chybu nedostatočného zostatku.

Ak zamietnutie súvisí s bankou, ktorá kartu vydala, zmena e-mailu, jazyka rozhrania ani nastavení profilu nemení platobné podmienky. Tento mechanizmus vysvetľuje príklad zahraničnej karty pre Claude.

A nezabúdajte, že konečné rozhodnutie robí platobná brána. Môže platbu zamietnuť z vlastných dôvodov a neexistuje záruka, že prejde.

Kde začať?#

Stručný plán krok za krokom:

1. V /auth overte možnosti svojej verzie Qwen Code a vyberte platformu vydania kľúča a spôsob účtovania. Ďalší postup sa týka štandardného kľúča API Model Studio; starý Qwen OAuth a predplatné Coding Plan sú samostatné cesty.
2. Vytvorte si účet u poskytovateľa. Najjednoduchšou možnosťou je priamo Alibaba.
3. Vystavte si kľúč v účte poskytovateľa, v sekcii prístupových kľúčov. Jeho vystavenie je bezplatné; kartu na to nepotrebujete.
4. Zlúčte regionálne pripojenie do ~/.qwen/settings.json bez hodnoty tajného kľúča. V spúšťajúcom termináli nastavte DASHSCOPE_API_KEY, potom overte vybraný model a jednu krátku odpoveď podľa vyššie uvedeného postupu.
5. Ak chcete platiť za používanie, potrebujete kartu vydanú na vaše meno, ktorú platobná brána poskytovateľa akceptuje. Podmienky dobitia určuje platobná brána; vystavenie kľúča a platba za používanie sú dva samostatné kroky.

Zvážte aj to, ktorý model potrebujete. Na náročné úlohy si vyberte výkonnejší Qwen3-Coder-Plus; ak chcete ušetriť, vyberte ľahší Flash, ktorý je pri rovnakom objeme niekoľkonásobne lacnejší. Návod Qwen Code ako náhrada za Claude Code ukazuje, čím sa Qwen Code líši od iných terminálových agentov.

Ďalšie materiály nájdete na Ailoot.