API klíč Qwen Code: kde ho vydat, připojit a jak vypočítat spotřebu

Někdo nainstaluje Qwen Code, spustí ho v terminálu a hned při prvním požadavku se objeví výzva k zadání klíče. Pak začíná hledání: lidé zadávají „buy api key for qwen code“ a dostávají se na stránky, kde jim prodávají buď předplatné, nebo hotový přístup někoho jiného. Tady se dozvíte, co klíč je, kde ho získat a kolik stojí, krok za krokem.

Hlavní pointa hned na začátku: API klíč se neprodává jako samostatný zabalený produkt. Je to přístupový řetězec, který si sami vydáte v účtu poskytovatele modelu, a jeho vydání je zdarma. Peníze potřebujete až později, když dobíjíte zůstatek; v tomto kroku platí podmínky poskytovatele. Níže se dozvíte, kde klíč získat, jak ho připojit k Qwen Code a kolik jeho používání stojí.

Co přesně je API klíč pro Qwen Code?#

Qwen Code je AI agent s otevřeným zdrojovým kódem, který běží v terminálu a píše kód pro vaše úkoly. Je zdarma, instaluje se přes npm a nemá v sobě vlastní neuronovou síť. Veškerou inteligentní práci vykonává model, který běží na serverech poskytovatele.

Qwen Code potřebuje povolení k přístupu k modelu. Tímto povolením je API klíč — dlouhý řetězec podobný heslu, který vám poskytovatel vydá osobně. Když agent odešle požadavek, připojí klíč; poskytovatel podle něj zjistí, čí požadavek to je, odpoví a odečte spotřebu z vašeho zůstatku.

Z toho plyne jednoduchá věc, která vyjasní polovinu nedorozumění. Klíč se nekupuje jako produkt na tržišti: vytvoříte si účet u poskytovatele, kliknete na „vytvořit klíč“ a řetězec dostanete zdarma. Hledání „buy api key“ ve skutečnosti znamená „kde si vytvořím účet a jak potom zaplatím za používání“ — obě otázky zodpovídáme níže.

Jak se API klíč Qwen Code liší od předplatného a bezplatného přihlášení?#

Příkaz /auth uvnitř Qwen Code ukazuje možnosti ověřování podporované nainstalovanou verzí. Vyberte položku pro platformu, která vydala váš klíč, a její způsob účtování. Následující rozlišení vysvětluje staré bezplatné přihlášení, Coding Plan a standardní klíč API použitý v tomto návodu; nejde o úplný seznam dnešních položek nabídky.

První možností je bezplatné přihlášení přes účet Qwen (Qwen OAuth). Dříve poskytovalo přístup k modelu bez klíče, ale bylo ukončeno.

Druhou možností je předplatné Coding Plan platformy Alibaba ModelStudio. Platí se pevná měsíční částka, která vám poskytne týdenní kvótu požadavků a samostatnou adresu pro připojení.

Třetí možností je API klíč od poskytovatele modelu. Neplatíte žádný pevný poplatek: dobijete si zůstatek a při práci z něj čerpáte podle měřené spotřeby tokenů. Tato možnost je flexibilní a hodí se, pokud agenta používáte nepravidelně. Zbytek tohoto článku se zaměřuje na ni.

Kde lze vydat API klíč pro Qwen Code?#

Protože Qwen Code rozumí různým protokolům, nejste omezeni na jediného poskytovatele klíče. Oficiální dokumentace výslovně uvádí služby, ke kterým se může připojit.

Níže je popsána cesta přímého připojení.

Pro přímé připojení otevřete konzoli Alibaba Model Studio, vyberte zamýšlený region a vytvořte klíč na stránce správy klíčů API. U konfigurace uchovejte název regionu a pracovního prostoru; klíč nekopírujte do sdílených poznámek.

Průvodce regiony doporučuje pro produkci domény vyhrazené pracovnímu prostoru. Zkopírujte skutečný API Host ze správy Workspace Management a postupujte podle průvodce základními URL; nevymýšlejte ID pracovního prostoru. Existující sdílené endpointy DashScope a endpointy vyhrazené pracovnímu prostoru jsou různé možnosti přístupu. Coding Plan a Token Plan také používají vlastní endpointy a klíče. Z konzole zvoleného regionálního pracovního prostoru zkopírujte úplnou OpenAI-kompatibilní základní URL do DASHSCOPE_BASE_URL. JSON záměrně neobsahuje baseUrl; před spuštěním se adresa předá přes OPENAI_BASE_URL. Použijte skutečné údaje z konzole, nikoli zástupný identifikátor.

Existuje také bezplatná možnost, která nevyžaduje žádný klíč: spusťte model Qwen na svém počítači přes Ollama a připojte k němu Qwen Code jako k vlastnímu serveru. Vyžaduje to výkonný počítač a samostatné nastavení. Postup spuštění agenta lokálně najdete v průvodci spuštěním Qwen Code v terminálu.

Jak přidat klíč do Qwen Code, aby fungoval?#

Zálohujte současná nastavení a níže uvedené připojení slučte do ~/.qwen/settings.json; nepřepisujte nesouvisející poskytovatele ani preference. Tato ilustrativní konfigurace vychází z příkladu ověřování Qwen Code s URL pracovního prostoru předanou přes OPENAI_BASE_URL, klíčem API načteným z proměnné prostředí určené v envKey a vynechaným blokem env s klíčem v prostém textu. qwen3-coder-plus je model z oficiálního příkladu; nejprve ověřte jeho dostupnost pro vybraný region a účet, nebo v obou místech použijte skutečné ID modelu z konzole daného regionu.

Z konzole zvoleného regionálního pracovního prostoru zkopírujte úplnou OpenAI-kompatibilní základní URL do DASHSCOPE_BASE_URL. JSON záměrně neobsahuje baseUrl; před spuštěním se adresa předá přes OPENAI_BASE_URL. Použijte skutečné údaje z konzole, nikoli zástupný identifikátor.

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

openai volí kompatibilní protokol. envKey pojmenovává proměnnou, kterou Qwen Code čte; není to hodnota klíče. model.name musí odpovídat nastavenému id. Tato pole popisuje referenční dokumentace poskytovatelů modelů.

Na macOS nebo Linuxu otevřete terminál Bash, zadejte klíč do skryté výzvy a ve stejném terminálu spusťte 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

Ve Windows použijte 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

Příkazy ponechávají doslovný tajný klíč mimo JSON a historii příkazů; běžící proces jej stále dostává do svého prostředí. Nevypisujte jej, neukládejte do repozitáře ani nevkládejte do zadání. Při přechodu na tento postup odstraňte z nastavení starou položku env obsahující tajný klíč. V novém terminálu je nutné proměnnou dodat znovu.

V Qwen Code použijte /doctor ke kontrole ověřování a /model ke kontrole vybrané konfigurace. V neškodné prázdné testovací složce pošlete: „Odpověz slovem connected. Nečti ani neměň soubory a nespouštěj příkazy.“ Úspěšná odpověď ověřuje jeden požadavek na model a může být zpoplatněna podle spotřeby. Zobrazení nastaveného modelu v /model potvrzuje pouze místní konfiguraci.

Pokud požadavek selže, zaznamenejte redigovanou chybu a ID požadavku, je-li dodáno. Ověřování kontrolujte odděleně od dostupnosti modelu a účtování: ve stejné konzoli poskytovatele zkontrolujte vydávající platformu klíče, region a pracovní prostor, standardní endpoint oproti endpointu tarifu, ID modelu i zůstatek a kvótu účtu. Chyba 401 může odrážet nesoulad klíče a endpointu nebo platebního plánu; není důkazem poruchy poskytovatele. Po neúspěšném testu zastavte a před dalším pokusem opravte zdokumentovaný nesoulad. Článek popisuje příklad podle dokumentace, nikoli placený požadavek provedený pro tento návod.

Kolik stojí práce s API klíčem a co zvyšuje účet?#

Klíč se od předplatného liší tím, že nemá pevnou měsíční částku. Platíte za to, co model přečte a napíše, měřeno v tokenech. Token je kousek textu dlouhý přibližně několik písmen. Každý model má vlastní cenu za milion vstupních a milion výstupních tokenů, přičemž výstup téměř vždy stojí víc než vstup.

Milion tokenů zní jako hodně, ale při práci na velkém projektu ubývají rychleji, než byste čekali: agent při každém požadavku načítá vaše soubory celé.

Praktický závěr je tento: účet závisí na množství textu, který agent zpracovává. Dlouhé soubory, dlouhé relace a neustálé opakované čtení kódu spotřebují zůstatek nejrychleji; počet úkolů je druhořadý. Samostatný článek krok za krokem vysvětluje jak se počítá spotřeba API tokenů a proč může zůstatek ubývat, aniž si toho všimnete.

Proč jsou platby odmítány?#

Právě tady dochází k časté chybě.

Překážka se objeví až o krok později. Klíč jste vydali, ale bez peněz na zůstatku nic čerpat nebude — poskytovatel vrátí chybu nedostatečných prostředků.

Pokud odmítnutí souvisí s bankou, která kartu vydala, změna e-mailu, jazyka rozhraní nebo nastavení profilu platební podmínky nezmění. Tento mechanismus je vysvětlen na příkladu zahraniční karty pro Claude.

Počítejte také s tím, že konečné rozhodnutí činí platební brána. Může platbu odmítnout z vlastních důvodů a není zaručeno, že ji přijme.

Kde začít?#

Stručný plán krok za krokem:

1. V /auth ověřte možnosti své verze Qwen Code a zvolte platformu vydání klíče a způsob účtování. Další postup se týká standardního klíče API Model Studio; starý Qwen OAuth a předplatné Coding Plan jsou samostatné cesty.
2. Vytvořte si účet u poskytovatele. Nejjednodušší možností je přímo Alibaba.
3. Vydáte si klíč v účtu poskytovatele, v sekci přístupových klíčů. Jeho vydání je zdarma; kartu k tomu nepotřebujete.
4. Slučte regionální připojení do ~/.qwen/settings.json bez hodnoty tajného klíče. V terminálu, ze kterého aplikaci spouštíte, nastavte DASHSCOPE_API_KEY, poté ověřte vybraný model a jednu krátkou odpověď podle výše uvedeného postupu.
5. Za používání zaplatíte kartou vydanou na vaše jméno, kterou přijímá platební brána poskytovatele. Podmínky dobití určuje platební brána; vydání klíče a placení za používání jsou samostatné kroky.

Zvažte také, který model potřebujete. Pro náročné úkoly zvolte výkonnější Qwen3-Coder-Plus; chcete-li ušetřit, vyberte lehčí Flash, který je při stejném objemu několikanásobně levnější. Průvodce Qwen Code jako náhrada za Claude Code ukazuje, jak se Qwen Code liší od jiných terminálových agentů.

Další materiály najdete na Ailoot.