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

> Co je API klíč Qwen Code, jak se liší od předplatného, kde ho vydat, jak nastavit settings.json a co určuje spotřebu tokenů.

Source: https://ailoot.ai/blog/cs/qwen-code-api-key/
Canonical: https://ailoot.ai/blog/cs/qwen-code-api-key/
Language: cs
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-141
Revision: sha256-73e0d079c39425017428ee3a8f904a9708d5c7c756cc49c043d363d8048d6a8c


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í.

<div class="aside" data-semantic="callout" role="note" aria-label="Upozornění">

Upozornění

Tento materiál má informativní charakter a popisuje veřejná pravidla. Neuvádí zprostředkovatelské služby, které nabízejí „vyřízení“ plateb obcházením omezení, ani nevysvětluje způsoby, jak omezení obcházet. Ceny jsou převzaty ze stránek poskytovatelů k začátku září 2026; mění se, proto si aktuální ceny ověřte na webu poskytovatele.

</div>

<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Dokumentace Ailoot">

[Dokumentace Ailoot](https://ailoot.ai/docs/) — referenční materiály k používání služby.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

API klíč pro Qwen Code je osobní řetězec podobný heslu, který poskytovatel služby používá k identifikaci vašich požadavků na model a výpočtu jejich spotřeby. Samotný Qwen Code je bezplatný agent s otevřeným zdrojovým kódem; nemá vlastní vestavěný model. Odpovědi získává od externího poskytovatele a předává mu váš klíč. „Získat klíč“ tedy znamená zaregistrovat se u poskytovatele a vydat si přístupový řetězec v jeho účtu. V nastavení Qwen Code uveďte název proměnné prostředí a samotný klíč dodejte v terminálu, ze kterého aplikaci spouštíte, podle příkladu níže; požadavky se provádějí vaším jménem a účtují na váš účet.

</div>

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í?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

Qwen Code podporuje několik způsobů ověřování a účtování. Starý bezplatný tarif Qwen OAuth byl ukončen 15. dubna 2026. Alibaba Coding Plan používá předplatné a vyhrazený endpoint; standardní klíč API Model Studio používá průběžné účtování spotřeby. Současní klienti nabízejí také další platformy a tarify. Tento návod popisuje standardní klíč API Model Studio: region, endpoint, model a způsob účtování musejí patřit k sobě.

</div>

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.

<figure>
<blockquote>
<p>Bezplatná úroveň Qwen OAuth byla ukončena k 15. dubnu 2026. Dříve uložené tokeny mohou ještě nějakou dobu fungovat, ale nové požadavky budou odmítnuty.</p>
</blockquote>
<figcaption>— Dokumentace Qwen Code, ověřování, oficiální dokumentace</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

Qwen Code se může připojit k více poskytovatelům a protokolům. Pro přímé připojení k Alibaba Model Studio nejprve vyberte region v konzoli Model Studio a teprve potom vytvořte klíč. Klíč, základní URL API, pracovní prostor a dostupný model musejí odpovídat tomuto regionu. Mezinárodní adresa konzole ani anglické rozhraní samy o sobě neurčují region API.

</div>

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.

<figure>
<blockquote>
<p>Podporuje protokoly OpenAI, Anthropic, Gemini a Qwen. Libovolného poskytovatele třetí strany nebo místní model. Přepínejte za běhu.</p>
</blockquote>
<figcaption>— Dokumentace Qwen Code, ověřování, oficiální dokumentace</figcaption>
</figure>

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

Pro přímé připojení otevřete [konzoli Alibaba Model Studio](https://modelstudio.console.alibabacloud.com/), 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.

| Region vybraný pro klíč | Standardní základní URL kompatibilní s OpenAI | Co ověřit |
|----|----|----|
| Čína (Peking) | `DASHSCOPE_BASE_URL` | Pekingský klíč a model dostupný v tomto regionu |
| Singapur | `DASHSCOPE_BASE_URL` | Singapurský klíč a model dostupný v tomto regionu |
| USA (Virginie), včetně rozsahu nasazení Global nebo US | Zkopírujte API Host vybraného amerického pracovního prostoru a použijte jeho zdokumentovanou základní URL kompatibilní s OpenAI | Klíč amerického pracovního prostoru, rozsah nasazení a seznam modelů; nepoužívejte znovu adresu Pekingu nebo Singapuru |

[Průvodce regiony](https://www.alibabacloud.com/help/en/model-studio/regions) 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](https://www.alibabacloud.com/help/en/model-studio/base-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](https://ailoot.ai/blog/cs/qwen-code-terminal-auto-edit/).



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

V `~/.qwen/settings.json` nastavte protokol, regionální základní URL, ID modelu a `envKey`, název proměnné prostředí poskytující klíč. Hodnotu tajného klíče do JSON neukládejte. Spusťte Qwen Code z terminálu, ve kterém je proměnná nastavena, ověřte vybrané připojení a před spoléháním na funkčnost pošlete jedno krátké zadání. `/model` vypisuje nastavené volby; sám o sobě nedokládá přístup k poskytovateli.

</div>

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](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) 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.

```json
{
  "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ů](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/).

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:

```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
```

Ve Windows použijte PowerShell:

```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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

S API klíčem platíte podle měřené spotřeby: cenu za každých tisíc vstupních a výstupních tokenů, bez pevné měsíční částky. Lehčí modely, například Qwen3-Coder-Flash, stojí několikanásobně méně. Účet roste s objemem práce: čím delší jsou vaše soubory a čím více jich agent čte a zapisuje, tím vyšší je spotřeba. Přesnou cenu si vždy ověřte na stránce poskytovatele; mění se.

</div>

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ů](https://ailoot.ai/blog/cs/api-token-usage-calculation/) a proč může zůstatek ubývat, aniž si toho všimnete.

## Proč jsou platby odmítány?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

Abyste mohli začít čerpat prostředky prostřednictvím klíče, musíte dobít zůstatek. Pokud platební systém odmítne vaši kartu kvůli bance, která ji vydala, změnou e-mailu, jazyka nebo nastavení profilu se podmínky této karty nezmění.

</div>

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](https://ailoot.ai/blog/cs/claude-card-payment-requirements/).

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek">

Hlavní poznatek

Rozlišujte platformu a způsob účtování: starý bezplatný Qwen OAuth skončil, Coding Plan má předplatné a vlastní endpoint a tento návod popisuje standardní klíč API Model Studio účtovaný podle spotřeby. Vyberte odpovídající region, pracovní prostor, model a endpoint. V nastavení uložte název proměnné klíče, samotný tajný klíč dodejte v terminálu. Dobití zůstatku se řídí podmínkami platební brány poskytovatele.

</div>

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](https://ailoot.ai/blog/cs/qwen-code-token-plan-setup/) ukazuje, jak se Qwen Code liší od jiných terminálových agentů.

<div class="section" role="doc-bibliography" aria-label="Zdroje">

### Zdroje

- [Qwen Code - repozitář na GitHubu](https://github.com/QwenLM/qwen-code) - kód agenta s otevřeným zdrojovým kódem, instalace, podpora více protokolů a připojení poskytovatelů třetích stran
- [Qwen Code — dokumentace ověřování](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) — platformy a způsoby účtování, ukončení starého bezplatného OAuth a konfigurace připojení přes settings.json
- [Alibaba Model Studio — konzole](https://modelstudio.console.alibabacloud.com/) — výběr regionu a pracovního prostoru a správa klíčů API

</div>



Další materiály najdete na [Ailoot](https://ailoot.ai/).

## Časté otázky

### Je vydání klíče API totéž co nákup použití modelu?

Ne. Vydání přístupového řetězce a financování spotřeby jsou oddělené kroky. Poskytovatel přes klíč identifikuje a měří požadavky; samotný vydaný klíč nepotvrzuje použitelný zůstatek ani kvótu účtu.

### Co musí souhlasit v konfiguraci poskytovatele Qwen Code?

Zvolený protokol, základní URL poskytovatele, proměnná prostředí s klíčem a identifikátor modelu musí patřit ke stejnému připojení. V příkladu odpovídá model.name hodnotě id položky modelProviders; skutečný klíč nedávejte do sdílených kopií nastavení.


## Ailoot · Společnost a její portfolio projektů

Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.